Azure Key Vault への資格情報の格納

  • [アーティクル]

適用対象: Azure Data Factory Azure Synapse Analytics

ヒント

企業向けのオールインワン分析ソリューション、Microsoft Fabric の Data Factory をお試しください。 Microsoft Fabric は、データ移動からデータ サイエンス、リアルタイム分析、ビジネス インテリジェンス、レポートまで、あらゆるものをカバーしています。 無料で新しい試用版を開始する方法について説明します。

データ ストアや計算のための資格情報を Azure Key Vault に格納することができます。 Azure Data Factory は、データ ストア/計算を使うアクティビティの実行時に、資格情報を取得します。

現時点では、カスタム アクティビティを除くすべてのアクティビティの種類が、この機能をサポートしています。 具体的なコネクタの構成について詳しくは、各コネクタ トピックの「リンクされたサービスのプロパティ」セクションをご覧ください。

前提条件

この機能は、データ ファクトリのマネージド ID に依存しています。 データ ファクトリのマネージド ID からの使用方法と、データ ファクトリに関連付けられていることを確認する方法について説明します。

手順

Azure Key Vault に格納されている資格情報を参照するには、次の手順に従う必要があります。

  1. ファクトリと共に生成された "マネージド ID オブジェクト ID" の値をコピーして、データ ファクトリのマネージド ID を取得します。 ADF オーサリング UI を使用する場合、マネージド ID オブジェクト ID が Azure Key Vault のリンクされたサービスの作成ウィンドウに表示されます。Azure portal から取得することもできます。「Retrieve data factory service IDentity」(データ ファクトリのマネージド ID の取得) を参照してください。
  2. マネージド ID に、Azure Key Vault へのアクセス権を付与します。 キー コンテナーで、[アクセス ポリシー]、[アクセス ポリシーの追加] の順に選択し、このマネージド ID を検索して、[シークレットのアクセス許可] ドロップダウンで Get アクセス許可と List アクセス許可を付与します。 この指定されたファクトリで、キー コンテナー内のシークレットにアクセスできます。
  3. Azure Key Vault をポイントするリンクされたサービスを作成します。 「Azure Key Vault のリンクされたサービス」をご覧ください。
  4. データ ストアのリンク サービスを作成します。 構成で、Azure Key Vault に格納されている対応するシークレットを参照します。 「Azure Key Vault に格納されているシークレットを参照する」を参照してください。

Azure Key Vault のリンクされたサービス

Azure Key Vault のリンクされたサービスでは、次のプロパティがサポートされます。

プロパティ Description 必須
type type プロパティは、次のように設定する必要があります:AzureKeyVault。 はい
baseUrl Azure Key Vault の URL を指定します。 はい

オーサリング UI の使用:

[接続] ->[リンク サービス] ->[新規] を選択します。 新しいリンクされたサービスで、"Azure Key Vault" を検索して選択します。

Search Azure Key Vault

資格情報が格納されるプロビジョニングされた Azure Key Vault を選択します。 テスト接続を実行し、AKV 接続が有効なことを確認します。

Configure Azure Key Vault

JSON の例:

{
    "name": "AzureKeyVaultLinkedService",
    "properties": {
        "type": "AzureKeyVault",
        "typeProperties": {
            "baseUrl": "https://<azureKeyVaultName>.vault.azure.net"
        }
    }
}

キー コンテナーに格納されたシークレットの参照

キー コンテナーのシークレットを参照するリンクされたサービスのフィールドを構成する場合は、次のプロパティがサポートされます。

プロパティ Description 必須
type フィールドの type プロパティは、AzureKeyVaultSecret に設定する必要があります。 はい
secretName Azure Key Vault 内のシークレットの名前。 はい
secretVersion Azure Key Vault 内のシークレットのバージョン。
指定しない場合は、常に最新バージョンのシークレットが使用されます。
指定した場合は、その特定のバージョンに固定されます。		 いいえ
store 資格情報の格納に使用する Azure Key Vault のリンクされたサービスを表します。 はい

オーサリング UI の使用:

データストア/コンピューティングへの接続を作成するときに、シークレット フィールドに対して Azure Key Vault を選択します。 プロビジョニングされた Azure Key Vault のリンクされたサービスを選択し、シークレット名を指定します。 シークレット バージョンも必要に応じて指定できます。

ヒント

SQL Server や Blob ストレージなどのリンクされたサービスにおける接続文字列を使用した接続については、AKV でのパスワードなどの secret フィールドのみを格納するか、AKV の接続文字列全体を確認するかを選択できます。 どちらのオプションも UI で入手できます。

Configure Azure Key Vault secret

JSON の例: ("password" セクションをご覧ください)

{
    "name": "DynamicsLinkedService",
    "properties": {
        "type": "Dynamics",
        "typeProperties": {
            "deploymentType": "<>",
            "organizationName": "<>",
            "authenticationType": "<>",
            "username": "<>",
            "password": {
                "type": "AzureKeyVaultSecret",
                "secretName": "<secret name in AKV>",
                "store":{
                    "referenceName": "<Azure Key Vault linked service>",
                    "type": "LinkedServiceReference"
                }
            }
        }
    }
}

関連するコンテンツ

Azure Data Factory のコピー アクティビティによってソースおよびシンクとしてサポートされるデータ ストアの一覧については、サポートされるデータ ストアの表をご覧ください。