API開発者向けガイダンス :: GlobalSign Atlas Documentation

この記事では、Atlas APIを使用するアプリケーションを開発者が構築するためのプロセスフローを説明します

証明書を発行するには、まず Atlas にログイン、次に証明書を取得し、最後に証明書の信頼チェーンを確認するという、以下の一連の API 呼び出しに従います。

POST /login
Atlas API認証情報と mTLS 証明書を使用してログインし、後続のアクションに必要な JWS トークンを取得します。
GET /validationpolicy
証明書を取得するために必要な必須フィールドとオプションフィールドのリストを取得します。
POST /certificates
認証ポリシーの結果を使用して、新しい証明書を要求するために必要なフィールドを指定します。
GET /certificates/{certificate}
発行済みの証明書を取得します。発行済みの場合は証明書が返されます。そうでない場合は、次の手順を示すステータスまたはエラーが提供されます。
GET /trustchain
発行された証明書の信頼チェーンを取得します。これは、最終的な設定と対象アプリケーションでの使用に必要となります。完全なチェーンがないと、発行された証明書が証明書利用者によって信頼されない可能性があります。発行CAは随時変更される可能性があり、正しい証明書チェーンを維持することでサービスの中断を防ぐことができるため、発行ごとにこの操作を行うことが重要です。

証明書を発行するAtlas製品がドメイン認証（SSL/TLSなど）を必要とする場合、証明書を発行する前に、以下のAPI呼び出しシーケンスに従ってドメインを認証する必要があります。ドメイン認証前に証明書をリクエストしようとすると、エラーが発生します。

POST /claims/domains/{domain}
ドメインの所有権を証明するための新しい「クレーム」を生成し、後続のアクション用のclaimIDを受け取ります。
POST /claims/domains/{claimID}/<validationmethod>
claimIDを使用して、3つのドメイン認証方法のいずれかを選択し、ドメインの所有権を確認します。認証方法に関わらず、該当するHTTPまたはDNSロケーションの更新、またはメールの確認と処理には別途手動対応が必要です。
GET /claims/domains
ドメインクレームのステータスを取得します。ドメインが認証されたら、証明書をリクエストできます。
POST /claims/domains/{claimID}/reassert
有効期限が切れる前に、元のclaimIDを使用してドメインを更新します。このAPIは、ドメイン認証用の新しいトークンを発行します。