Compartilhar via


Autenticando o provedor de serviços

Para ser acessível no Windows Media Gerenciador de Dispositivos, um provedor de serviços deve herdar e implementar a interface IComponentAuthenticate.

Para se autenticar, um provedor de serviços executa as seguintes etapas:

  1. Na instanciação, ele cria um novo objeto CSecureChannelServer global e define os valores de certificado e chave de seu arquivo de chave.
  2. Ele implementa os métodos IComponentAuthenticate::SACAuth e IComponentAuthenticate::SACGetProtocols simplesmente passando os parâmetros para seu membro global CSecureChannelServer.
  3. Antes de lidar com métodos implementados do Windows Media Gerenciador de Dispositivos, o provedor de serviços deve verificar a autenticação do chamador chamando CSecureChannelServer::fIsAuthenticated e falhando se o chamador não estiver autenticado.

Essas etapas são mostradas nos exemplos do C++ a seguir.

Criando o objeto CSecureChannelServer

CMyServiceProvider::CMyServiceProvider()
{
    HRESULT hr = S_OK;

    // Create the persistent SAC object.
    g_pSAC = new CSecureChannelServer();

    // Set the SAC certificate.
    if (g_pSAC)
    {
        hr = g_pSAC->SetCertificate(
             SAC_CERT_V1,
            (BYTE*)abCert, sizeof(abCert), // SP's certificate.
            (BYTE*)abPVK, sizeof(abPVK)    // SP's key.
        );
    }   
    if (FAILED(hr)) return hr;

    //... Perform other class initialization here ...

    return hr;
}

Implementando os métodos IComponentAuthenticate

STDMETHODIMP CMDServiceProvider::SACAuth(
    DWORD   dwProtocolID,
    DWORD   dwPass,
    BYTE   *pbDataIn,
    DWORD   dwDataInLen,
    BYTE  **ppbDataOut,
    DWORD  *pdwDataOutLen)
{
    HRESULT hr = S_OK;

    // Verify that the global CSecureChannelServer member still exists.
    if (!g_pSAC)
        return E_FAIL;

    // Just pass the call to the global SAC member.
    hr = g_pSAC->SACAuth(
        dwProtocolID,
        dwPass,
        pbDataIn, dwDataInLen,
        ppbDataOut, pdwDataOutLen
    );
    return hr;
}

STDMETHODIMP CMDServiceProvider::SACGetProtocols(
    DWORD **ppdwProtocols,
    DWORD  *pdwProtocolCount)
{
    HRESULT hr = E_FAIL;

    if (!g_pSAC)
        return hr;

    hr = g_pSAC->SACGetProtocols(
        ppdwProtocols,
        pdwProtocolCount
    );
    return hr;
}

Verificando a autenticação do chamador

O exemplo de código a seguir mostra um provedor de serviços verificando a autenticação do chamador como parte de sua implementação da interface IMDServiceProvider .

STDMETHODIMP CMyServiceProvider::GetDeviceCount(DWORD * pdwCount)
{
    HRESULT hr = S_OK;
    if (!g_pSAC)
        return E_FAIL;

    if (!(g_pSAC->fIsAuthenticated()))
        return WMDM_E_NOTCERTIFIED;

    *pdwCount = m_DeviceCount;

    return hr;
}

Criando um provedor de serviços