アーティファクト署名は、完全に管理されたエンドツーエンドの証明書署名サービスMicrosoftです。 このクイック スタートでは、アーティファクト署名の使用を開始するために、次の 3 つの成果物署名リソースを作成します。
- アーティファクト署名アカウント
- ID 検証
- 証明書プロファイル
Azure ポータルまたは Azure CLI 拡張機能を使用して、アーティファクト署名リソースの大部分を作成および管理できます。 (Azure ポータルで id 検証 only を完了できます。Azure CLIを使用して ID 検証を完了することはできません。)このクイック スタートでは、その方法について説明します。
[前提条件]
注
パブリック トラスト証明書の場合、アーティファクト署名は現在、米国、カナダ、欧州連合、英国の組織、および米国およびカナダの個々の開発者が利用できます。 この制限は、プライベート信頼証明書には適用されません。
このクイック スタートを完了するには、次のものが必要です。
Microsoft Entra テナント ID。
詳細については、「Microsoft Entra テナントの作成を参照してください。
Azure サブスクリプション。
まだお持ちでない場合は、開始する前にAzure サブスクリプションの作成を参照してください。
成果物署名リソース プロバイダーを登録する
アーティファクト署名を使用する前に、アーティファクト署名リソース プロバイダーを登録する必要があります。
リソース プロバイダーは、Azureリソースを提供するサービスです。 Azure ポータルまたはAzure CLIを使用して、Microsoft.CodeSigning Artifact Signing リソース プロバイダーを登録します。
Azure ポータルを使用してアーティファクト署名リソース プロバイダーを登録するには:
Azure ポータルにサインインします。
検索バーまたは [すべてのサービス] の下で、[サブスクリプション] を選択します。
成果物署名リソースを作成するサブスクリプションを選択します。
リソース メニューの [設定] で、[リソース プロバイダー] を選択します。
リソース プロバイダーの一覧で、Microsoftを選択します。CodeSigning。
既定では、リソース プロバイダーの状態は "NotRegistered" です。
省略記号を選択し、[登録] を選択します。
Microsoft.CodeSigning リソースプロバイダーが登録されていることを示すスクリーンショット。 リソース プロバイダーの状態が[登録済み] に変わります。
アーティファクト署名アカウントを作成する
アーティファクト署名アカウントは、ID 検証と証明書プロファイル リソースを保持する論理コンテナーです。 ID 検証はサブスクリプション ID レベルで使用でき、そのサブスクリプション内のすべての成果物署名アカウント間で共有できます。
Azureの成果物の署名をサポートするリージョン
成果物署名リソースは、サービスが現在使用できるAzureリージョンでのみ作成できます。 次の表に、現在成果物署名リソースをサポートしているAzureリージョンを示します。
| リージョン | リージョンクラスのフィールド | エンドポイントの URI 値 |
|---|---|---|
| ブラジル南部 | ブラジル南部 | https://brs.codesigning.azure.net |
| 米国中部 | セントラルUS | https://cus.codesigning.azure.net |
| 米国東部 | イーストUS | https://eus.codesigning.azure.net |
| 東日本 | JapanEast | https://jpe.codesigning.azure.net |
| 韓国中部 | KoreaCentral | https://krc.codesigning.azure.net |
| 米国中北部 | NorthCentralUS | https://ncus.codesigning.azure.net |
| 北ヨーロッパ | NorthEurope | https://neu.codesigning.azure.net |
| ポーランド中部 | ポーランドセントラル | https://plc.codesigning.azure.net |
| 米国中南部 | SouthCentralUS | https://scus.codesigning.azure.net |
| スイス北部 | スイス北部 | https://swn.codesigning.azure.net |
| 米国中西部 | WestCentralUS | https://wcus.codesigning.azure.net |
| 西ヨーロッパ | 西ヨーロッパ | https://weu.codesigning.azure.net |
| 米国西部 | WestUS | https://wus.codesigning.azure.net |
| 米国西部 2 | WestUS2 | https://wus2.codesigning.azure.net |
| 米国西部 3 | WestUS3 | https://wus3.codesigning.azure.net |
アーティファクト署名アカウントの名前付け制約
アーティファクト署名アカウント名には、いくつかの制約があります。
成果物署名アカウント名は次の条件を満たす必要があります。
- 3 - 24 文字の英数字を含む。
- グローバルで唯一無二の存在になる。
- 文字で始める。
- 文字または数字で終了します。
- 連続するハイフンを含まない。
成果物署名アカウント名は次のとおりです。
- 大文字と小文字の区別はされない (ABC は abc と同じ)。
- "one" で始まる場合、Azure Resource Managerによって拒否されます。
Azure ポータルを使用してアーティファクト署名アカウントを作成するには:
Azure ポータルにサインインします。
アーティファクト署名アカウントを検索して選択します。
** ```
Azure ポータルでアーティファクト署名アカウントの検索を示すスクリーンショット [ 成果物署名アカウント ] ウィンドウで、[ 作成] を選択します。
Subscription で、Azure サブスクリプションを選択します。
[リソース グループ] で [新規作成] を選択して、リソース グループ名を入力します。
[アカウント名] には、一意のアカウント名を入力します。
詳細については、「 アーティファクト署名アカウントの名前付け制約」を参照してください。
Region で、成果物の署名をサポートするAzureリージョンを選択します。
[価格] では、価格レベルを選びます。
[確認および作成] ボタンを選択します。
アーティファクト署名アカウントを正常に作成したら、[ リソースに移動] を選択します。
ID 検証要求を作成する
証明書に含まれているはずの情報でリクエスト フォームを埋めることで、独自の ID 検証を実行できます。 ID 検証は、Azure ポータルでのみ完了できます。 Azure CLIを使用して ID 検証を完了することはできません。
注
適切なロールが割り当てられない場合、ID 検証要求を作成することはできません。 Azure ポータルでメニュー バーの new identity ボタンが淡色表示されている場合は、アーティファクト署名 ID 検証ツール ロールが割り当てられていることを確認して ID 検証を続行します。
組織または DBA の ID 検証要求を作成するには:
Azure ポータルで、新しい成果物署名アカウントに移動します。
アーティファクト署名アイデンティティ検証者ロールが割り当てられているかどうか確認します。
ロールベースのアクセス制御 (RBAC) を使用してアクセスを管理する方法については、「 チュートリアル: 成果物の署名でロールを割り当てる」を参照してください。
[成果物署名アカウント の概要 ] ウィンドウまたは [ オブジェクト] のリソース メニューで、[ ID 検証] を選択します。
[新しい ID] を選択し、 [パブリック] または [プライベート] を選択します。
- パブリック ID 検証が適用される証明書プロファイルの種類は、パブリック信頼、パブリック信頼テスト、VBS エンクレーブのみです。
- プライベート ID 検証が適用される証明書プロファイルの種類は、プライベート信頼、プライベート信頼 CI ポリシーのみです。
[新しい ID 検証] で、以下の情報を入力します。
田畑 詳細 組織名 パブリック ID 検証の場合は、証明書の発行先となる法人を指定します。 プライベート ID 検証の場合、既定値は Microsoft Entra テナント名になります。 (プライベート ID 型のみ) 組織単位 関連情報を入力します。 Web サイト URL 法人に属する Web サイトを入力します。 プライマリメール 検証中の法人に関連付けられている電子メール アドレスを入力します。 ID 検証プロセスの一部として、検証リンクがこのメール アドレスに送信されます。リンクの有効期限は 7 日間です。 このメール アドレスが外部メール アドレスからメール (リンクを含む) を受信できることを確認してください。 これは、検証済みの資格情報と電子メールの検証を完了するためのリンクが送信される電子メール アドレスです。 セカンダリ メール このメール アドレスは、プライマリ メール アドレスとは異なる必要があります (配布リストは受け入れられます)。 組織の場合、ドメインはプライマリ メール アドレスで指定されたメール アドレスのものと一致する必要があります。 このメール アドレスが外部メール アドレスからリンクを含むメールを受信できることを確認します。 ビジネス識別子 法人のビジネス識別子を入力します。 販売者 ID Microsoft Storeのお客様にのみ適用されます。 パートナー センター ポータルで自身の販売者 ID を見つけてください。 通り、市、国/地域、州/県、郵便番号 法人の所在地を入力します。 [First Name] 個々の ID 検証を実行する組織を表す個人の名を入力します。 ID 検証プロセスの政府発行の ID ドキュメントに表示される正確な名前を使用します。 [Last Name] 組織を表す個人の姓を入力します。 この個人は、個々の ID 検証を実行します。 ID 検証プロセスの政府発行の ID ドキュメントに表示される正確な名前を使用します。 [証明書サブジェクトのプレビュー] を選択すると、証明書に表示される情報のプレビューが表示されます。
[作成] ボタンを選択します。
要求が正常に作成されると、ID 検証要求の状態が "進行中" に変わります。
状態が [ アクションが必要] に変わったら、上記の [Identity Validation - Individual Developer]\(ID 検証 - 個々の開発者\) タブの手順 9 以降の手順に従います。
個々の ID 検証のリンクも、メール経由でプライマリ メール アドレスに送信されます。
個々の ID 検証が正常に完了すると、状態が [進行中] に戻り、検証プロセスが続行されます。
追加のドキュメントが必要な場合は、電子メールが送信され、要求の状態が "アクションが必要" に変わります。
ID 検証プロセスが完了すると、要求の状態が変わり、要求の更新された状態を含む電子メールが送信されます。
- "完了": プロセスが正常に完了した場合。
- "失敗": プロセスが正常に完了していない場合。
![[New identity validation] (新しい ID 検証) ウインドウの [Public] (パブリック) オプションを示すスクリーンショット。](media/artifact-signing-identity-validation-public.png)
![[New identity validation] (新しい ID 検証) ウインドウの [Private] (プライベート) オプションを示すスクリーンショット。](media/artifact-signing-identity-validation-private.png)
![[New identity validation] (新しい ID 検証) ウインドウの [Public] (パブリック) オプションを示すスクリーンショット。](media/artifact-signing-identity-validation-public.png#lightbox)
![[New identity validation] (新しい ID 検証) ウインドウの [Private] (プライベート) オプションを示すスクリーンショット。](media/artifact-signing-identity-validation-private.png#lightbox)
パブリック ID 検証の重要な情報
| Requirements | 詳細 |
|---|---|
| 入社手続き | より迅速なオンボーディング プロセスのために、検証対象の法人のパブリック レコードが最新であることを確かめます。 |
| 精度 | パブリック ID 検証に対して正しい情報を提供していることを確認してください。 作成後に変更を加える必要がある場合は、新しい ID 検証要求を完了する必要があります。 この変更は、署名に使用中の関連付けられた証明書に影響します。 |
| メール確認の失敗 | メール確認が失敗した場合は、新しい ID 検証要求を開始する必要があります。 |
| ID 検証の状態 | ID 検証の状態に更新があると、メールで通知されます。 Azure ポータルでいつでも状態を確認することもできます。 |
| 処理時間 | ID 検証要求の処理には 1 ~ 20 営業日かかります (より多くのドキュメントを要求する必要がある場合は、さらに長くなる可能性があります)。 |
| その他のドキュメント | Microsoft が ID 検証要求を処理するために追加のドキュメントが必要な場合は、メールで通知されます。 Azure ポータルでドキュメントをアップロードできます。 ドキュメントのアップロードには、3 つの試行があります。 ドキュメントの要求メールには、ファイル サイズの要件に関する情報が含まれています。 指定したドキュメントが最新であることを確認します。 - 提出されるすべてのドキュメントは、過去 12 か月以内に発行する必要があり、有効期限が 2 か月以上離れた将来の日付になります。 - 追加のドキュメントを提供できない場合は、既に提供されている法的ドキュメントまたは正式な会社登録の詳細と一致するようにアカウント情報を更新します。 - ID 検証要求の作成時に指定された会社名と住所が記載された、ビジネス登録フォーム、ビジネス チャーター、定款などの正式なビジネス ドキュメントを提供する場合。 - エンティティと連絡先の名前と、要求に含まれる/記載されているすべてのドメインを一覧表示する、登録または更新からのドメイン登録またはドメインの請求書を確認します。 |
![[確認済み ID の開始画面] を示すスクリーンショット。](media/artifact-signing-begin-on-laptop.png#lightbox)
証明書プロファイルの作成
証明書プロファイル リソースは、署名のためにお客様に対して発行される証明書の論理コンテナーです。
証明書プロファイルの名前付け制約
証明書プロファイル名にはいくつか制約があります。
証明書プロファイル名は次のことを満たす必要があります:
- 5 - 100 文字の英数字を含む。
- 文字で始まり、文字または数字で終わり、連続するハイフンを含まない。
- アカウント内でユニークな存在であること。
証明書プロファイル名は:
- 既定では、アカウントと同じAzureリージョンで継承されます。
- 大文字と小文字の区別はされない (ABC は abc と同じ)。
Azure ポータルで証明書プロファイルを作成するには:
Azure ポータルで、新しい成果物署名アカウントに移動します。
[成果物署名アカウント の概要 ] ウィンドウまたは [オブジェクト ] のリソース メニューで、[ 証明書プロファイル] を選択します。
コマンド バーで、[作成] を選択し、証明書プロファイルの種類を選択します。
[証明書プロファイルの作成] で、次の情報を入力します。
a. [証明書プロファイル名] には、一意の名前を入力します。
詳細については、「証明書プロファイルの名前付け制約」を参照してください。
[証明書の種類] には選択した証明書プロファイルの種類に基づいた値が自動で入力されます。
b。 [検証済み CN および O] で、証明書に表示する必要がある ID 検証を選択します。
番地を証明書に表示する必要がある場合は、[Include street address] (番地を含める) チェックボックスを選択します。
郵便番号を証明書に表示する必要がある場合は、[Include postal code (郵便番号を含める) チェックボックスを選択します。
残りのフィールドの値は、[検証済み CN および O] の選択内容に基づいて自動で入力されます。
生成された証明書サブジェクトのプレビューには、発行される証明書のプレビューが表示されます。
を選択してを作成します。
![[証明書プロファイルの作成] ウインドウを示すスクリーンショット。](media/artifact-signing-certificate-profile-creation.png)
![[証明書プロファイルの作成] ウインドウを示すスクリーンショット。](media/artifact-signing-certificate-profile-creation.png#lightbox)
リソースをクリーンアップする
Azure ポータルを使用してアーティファクト署名リソースを削除するには:
証明書プロファイルの削除
- Azure ポータルで、アーティファクト署名アカウントに移動します。
- [成果物署名アカウント の概要 ] ウィンドウまたは [オブジェクト ] のリソース メニューで、[ 証明書プロファイル] を選択します。
- [証明書プロファイル] で、削除したい証明書プロファイルを選択します。
- コマンド バーの [削除] を選択します。
注
このアクションにより、証明書プロファイルに関連付けられているすべての署名が停止されます。
アーティファクト署名アカウントを削除する
- Azure ポータルにサインインします。
- 検索ボックスに「 アーティファクト署名アカウント」と入力して選択します。
- [成果物署名アカウント] で、削除する成果物署名アカウントを選択します。
- コマンド バーの [削除] を選択します。
注
このアクションにより、このアカウントに紐づけられたすべての証明書プロファイルが削除されます。 証明書プロファイルに関連付けられているすべての署名プロセスが停止されます。
関連コンテンツ
このクイック スタートでは、アーティファクト署名アカウント、ID 検証要求、および証明書プロファイルを作成しました。 アーティファクト署名の詳細と署名体験を開始するには、次の記事を参照してください。
- 署名の統合の詳細を確認する。
- アーティファクト署名でサポートされる信頼モデルの詳細について説明します。
- 証明書管理の詳細を確認する。
- セットアップに関するサポートが必要です。
- Azure ポータルから Azure サポートに問い合わせてください。
- Stack Overflow または Microsoft Q&A にクエリを投稿し、タグ「artifact-signing」を使用してください。
- ID 検証の問題は、Stack Overflow または Microsoft Q&A でのみ対処できます。