例: BITS での SSPI 認証エンコードの使用

[アーティクル]
03/11/2024

セキュリティサポートプロバイダーインターフェイス (SSPI) 認証およびバックグラウンドインテリジェント転送サービス (BITS) メソッドを使用して、ユーザーから資格情報を取得し、資格情報をエンコードし、エンコードされた資格情報を BITS 転送ジョブに設定できます。資格情報の構造を BITS 転送ジョブに渡すことができる文字列に変換するには、エンコードが必要です。

SSPI 認証とその方法の詳細については、、「SSPI」を参照してください。

次の手順では、Negotiate セキュリティパッケージを使用して、ユーザーからの資格情報の入力を求めます。プログラムは認証 ID 構造を作成し、その構造にユーザーのユーザー名、ドメイン、およびパスワードを表すエンコードされた文字列を設定します。次に、プログラムは BITS ダウンロードジョブを作成し、エンコードされたユーザー名とパスワードをジョブの資格情報として設定します。このプログラムは、不要になった認証 ID 構造を解放します。

この例では、「例: 共通クラス」で定義されているヘッダーと実装を使用します。

BITS 転送ジョブで SSPI 認証エンコードを使用するには

CCoInitializer 関数を呼び出して COM パラメーターを初期化します。 CCoInitializer 関数の詳細については、「例: 共通クラス」を参照してください。
IBackgroundCopyManager、IBackgroundCopyJob、IBackgroundCopyJob2 インターフェイスのポインターを取得します。この例では、CComPtr クラスを使用して COM インターフェイスポインターを管理します。
SspiPromptForCredentials 関数のダイアログボックスの外観をカスタマイズするための情報を含む、CREDUI_INFO 構造体を作成します。次に、ユーザーからの資格情報の入力を求めます。詳細については、SspiPromptForCredentials 関数のページを参照してください。
SspiEncodeAuthIdentityAsStrings 関数を使用して BITS 転送ジョブに渡すことができる文字列として資格情報構造をエンコードします。
BG_AUTH_CREDENTIALS 構造体を準備します。
CoInitializeSecurity を呼び出して COM プロセスのセキュリティを初期化します。 BITS には、少なくとも IMPERSONATE レベルの偽装が必要です。 BITS は、適切な偽装レベルが設定されていない場合、E_ACCESSDENIED で失敗します。
CoCreateInstance 関数を呼び出して、BITS への初期ロケーターを取得します。
IBackgroundCopyManager::CreateJob メソッドを呼び出して、転送ジョブを作成します。
IBackgroundCopyJob2 インターフェイスの識別子を取得し、IBackgroundCopyJob::QueryInterface メソッドを呼び出します。
BG_AUTH_CREDENTIALS 構造体にエンコードされたユーザー名とパスワードの文字列を設定し、認証スキームを Negotiate (BG_AUTH_SCHEME_NEGOTIATE) に設定します。
BITS に要求を行うには、IBackgroundCopyJob2 ポインターを使用します。このプログラムでは、IBackgroundCopyJob2::SetCredentials メソッドを使用して BITS 転送ジョブの資格情報を設定します。
ファイルの追加、プロパティの変更、BITS 転送ジョブの再開。
BITS 転送ジョブが完了したら、IBackgroundCopyJob::Complete を呼び出して、キューからジョブを削除します。
最後に、SspiFreeAuthIdentity 関数を呼び出して、認証 ID 構造を解放します。

次のコード例は、BITS 転送ジョブで SSPI 認証エンコードを使用する方法を示しています。

#define SECURITY_WIN32
#define _SEC_WINNT_AUTH_TYPES

#include <windows.h>
#include <ntsecapi.h>
#include <bits.h>
#include <sspi.h>
#include <wincred.h>
#include <iostream>
#include <atlbase.h>
#include "CommonCode.h"

void PromptForCredentials(PWSTR pwTargetName)
{
    HRESULT hr;
    
    // If CoInitializeEx fails, the exception is unhandled and the program terminates
    CCoInitializer coInitializer(COINIT_APARTMENTTHREADED);
    
    CComPtr<IBackgroundCopyManager> pQueueMgr;
    CComPtr<IBackgroundCopyJob> pJob;
    CComPtr<IBackgroundCopyJob2> pJob2;

    PSEC_WINNT_AUTH_IDENTITY_OPAQUE pAuthIdentityEx2 = NULL;
    DWORD dwFlags = 0;
    BOOL fSave = FALSE;
    BOOL bReturn = TRUE;

    CREDUI_INFO creduiInfo = { 0 };
    creduiInfo.cbSize = sizeof(creduiInfo);
    // Change the message text and caption to the actual text for your dialog.
    creduiInfo.pszMessageText = pwTargetName;
    creduiInfo.pszCaptionText = L"SSPIPFC title for the dialog box";

    try {
        // Prompt for credentials from user using Negotiate security package.
        DWORD dwRet = SspiPromptForCredentials(
            pwTargetName,
            &creduiInfo,
            0,
            L"Negotiate", 
            NULL,
            &pAuthIdentityEx2,
            &fSave,
            dwFlags
            );

        if (SEC_E_OK != dwRet) 
        {
            // Prompt for credentials failed.
            throw MyException(dwRet, L"SspiPromptForCredentials");
        }

        if (NULL != pAuthIdentityEx2) 
        {
            GUID guidJob;
            BG_AUTH_CREDENTIALS authCreds;

            PCWSTR pwUserName = NULL;
            PCWSTR pwDomainName = NULL;
            PCWSTR pwPassword = NULL;

            // Encode credential structure as strings that can
            // be passed to a BITS job.
            SECURITY_STATUS secStatus = SspiEncodeAuthIdentityAsStrings(
                pAuthIdentityEx2,
                &pwUserName,
                &pwDomainName,
                &pwPassword
                );

            if(SEC_E_OK != secStatus) 
            {
                // Encode authentication identity as strings.
                throw MyException(secStatus, L"SspiEncodeAuthIdentityAsStrings");   
            }

            // Show the encoded user name and domain name.
            wprintf(
                L"User Name: %s\nDomain Name: %s",
                pwUserName,
                pwDomainName
                );

            //The impersonation level must be at least RPC_C_IMP_LEVEL_IMPERSONATE.
            HRESULT hr = CoInitializeSecurity(
                NULL,
                -1,
                NULL,
                NULL,
                RPC_C_AUTHN_LEVEL_CONNECT,
                RPC_C_IMP_LEVEL_IMPERSONATE,
                NULL,
                EOAC_DYNAMIC_CLOAKING,
                0
                );
            
            if (FAILED(hr))
            {
                throw MyException(hr, L"CoInitializeSecurity");
            }

            // Connect to BITS.
            hr = CoCreateInstance(__uuidof(BackgroundCopyManager), NULL,
                CLSCTX_LOCAL_SERVER,
                __uuidof(IBackgroundCopyManager),
                (void**) &pQueueMgr);

            if (FAILED(hr))
            {
                // Failed to connect.
                throw MyException(hr, L"CoCreateInstance");
            }

            // Create a job.
            hr = pQueueMgr->CreateJob(
                L"EncodeSample", 
                BG_JOB_TYPE_DOWNLOAD, 
                &guidJob, 
                &pJob
                );

            if(FAILED(hr))
            {   
                // Failed to create a BITS job.
                throw MyException(hr, L"CreateJob");
            }

            // Get IBackgroundCopyJob2 interface.
            hr = pJob->QueryInterface(__uuidof(IBackgroundCopyJob2), (void**)&pJob2);
            if (FAILED(hr)) 
            {
                // Failed to get a reference to the IBackgroundCopyJob2 interface.
                throw MyException(hr, L"QueryInterface(IBackgroundCopyJob2)");
            }

            // Create a BITS authentication structure from the encoded strings.
            authCreds.Target = BG_AUTH_TARGET_SERVER;
            authCreds.Scheme = BG_AUTH_SCHEME_NEGOTIATE;
            authCreds.Credentials.Basic.UserName = (LPWSTR)pwUserName;
            authCreds.Credentials.Basic.Password = (LPWSTR)pwPassword;

            // Set the credentials for the job.
            hr = pJob2->SetCredentials(&authCreds);
            if (FAILED(hr)) 
            {
                // Failed to set credentials.
                throw MyException(hr, L"SetCredentials");
            }

            // Modify the job's property values.
            // Add files to the job.
            // Activate (resume) the job in the transfer queue.

            // Remove the job from the transfer queue.
            hr = pJob->Complete();
            if (FAILED(hr)) 
            {
                // Failed to complete the job.
                throw MyException(hr, L"Complete");
            }
        }
    }
    catch(std::bad_alloc &)
    {
        wprintf(L"Memory allocation failed");
        if (pJob != NULL)
        {
            pJob->Cancel();
        }
    }
    catch(MyException &ex)
    {
        wprintf(L"Error %x occurred during operation", ex.Error);
        if (pJob != NULL)
        {
            pJob->Cancel();
        }
    }

    // Free the auth identity structure.
    if (NULL != pAuthIdentityEx2)
    {
        SspiFreeAuthIdentity(pAuthIdentityEx2);
        pAuthIdentityEx2 = NULL;
    }

    return;
}

void _cdecl _tmain(int argc, LPWSTR* argv)
{
    PromptForCredentials(L"Target");
}

SSPI
IBackgroundCopyManager
IBackgroundCopyJob
IBackgroundCopyJob2
例: 共通クラス

次の方法で共有

例: BITS での SSPI 認証エンコードの使用

フィードバック

その他のリソース

次の方法で共有

例: BITS での SSPI 認証エンコードの使用

関連トピック

フィードバック

その他のリソース