Authentifizieren des Dienstanbieters

  • Artikel

Damit über Windows Media Geräte-Manager auf sie zugegriffen werden kann, muss ein Dienstanbieter die IComponentAuthenticate-Schnittstelle erben und implementieren.

Um sich selbst zu authentifizieren, führt ein Dienstanbieter die folgenden Schritte aus:

  1. Bei der Instanziierung wird ein neues globales CSecureChannelServer-Objekt erstellt und die Zertifikat- und Schlüsselwerte aus der Schlüsseldatei festgelegt.
  2. Es implementiert die Methoden IComponentAuthenticate::SACAuth und IComponentAuthenticate::SACGetProtocols , indem die Parameter einfach an den globalen CSecureChannelServer-Member übergeben werden.
  3. Vor der Verarbeitung implementierter Windows Media-Geräte-Manager-Methoden muss der Dienstanbieter die Authentifizierung des Aufrufers überprüfen, indem er CSecureChannelServer::fIsAuthenticated aufruft und fehlschlägt, wenn der Aufrufer nicht authentifiziert ist.

Diese Schritte werden in den folgenden C++-Beispielen gezeigt.

Erstellen des CSecureChannelServer-Objekts

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;
}

Implementieren der IComponentAuthenticate-Methoden

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;
}

Überprüfen der Authentifizierung des Aufrufers

Das folgende Codebeispiel zeigt, wie ein Dienstanbieter die Authentifizierung des Aufrufers im Rahmen seiner Implementierung der IMDServiceProvider-Schnittstelle überprüft.

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;
}

Erstellen eines Dienstanbieters