Oracle Cloud Infrastructureドキュメント

REST APIおよびCLIペイロード(アイデンティティ・ドメイン)でのアクセス・トークンの生成および使用

Oracle Analytics Cloudインスタンスをプログラムで作成する場合は、REST APIまたはCLI作成操作のペイロードに含めることができるアクセス・トークンを生成する必要があります。アクセス・トークンは、一定期間後に失効するように設定されているため、後続の作成操作でこのタスクを繰り返す必要がある場合があります。デフォルトでは、アクセス・トークンは1時間(3600秒)有効です。

ノート

これらの手順は、アイデンティティ・ドメインを使用するテナンシ用です。テナンシでOracle Identity Cloud Service (IDCS)を使用している場合は、REST APIおよびCLIペイロード(IDCS)でのアクセス・トークンの生成および使用を参照してください。

アクセス・トークンは、コンソールを使用して生成することも、(CLIまたはAPIを使用して)プログラム的に生成することもできます。

コンソールからアクセス・トークンを生成するには:

  1. Oracle Cloudアカウントに管理者としてサインインします。
  2. Oracle Cloud Infrastructure Consoleで、「アイデンティティとセキュリティ」に移動し、「ドメイン」をクリックします。
  3. 分析インスタンスを作成するアイデンティティ・ドメインの名前をクリックし、「統合アプリケーション」をクリックします。
  4. トークンを生成するために以前に作成したアプリケーションに移動します。たとえば、Analytics_Token_Appです。
  5. 「リソース」で、「アクセス・トークン」をクリックします。
    アクセス・トークン・ページ
  6. 「カスタマイズされたスコープ」を選択します。
  7. 「アイデンティティ・ドメインAPIの呼出し」を選択し、「自分」を指定します。
  8. 「トークンのダウンロード」をクリックし、tokens.tokファイルを保存します。

    tokens.tokには、属性名がapp_access_tokenのアクセス・トークンが含まれます。

  9. tokens.tokを開きます。

    次に例を示します。

    {"app_access_token":"eyJ4NXQjUzI...0jxcCw5oR0ajaNw"}
  10. アクセス・トークン値を引用符間にコピーします。たとえば、値eyJ4NXQjUzI...0jxcCw5oR0ajaNwです。
  11. このアクセス・トークンを使用してOracle Analytics Cloudインスタンスを作成するには、次のいずれかを実行します:
    • REST API CreateAnalyticsInstance: パラメータidcsAccessTokenでトークン値を指定します。
    • CLI analytics-instance create: トークン値をファイルにコピーし、CLIパラメータ--idcs-access-token-file [filename]でファイルの名前を指定します。
APIまたはCLIを使用してアクセス・トークンを生成するには:
  1. APIまたはCLIを使用して、アクセス・トークンを生成します。次に例を示します。
    curl 
-X POST 
-u "<client_id>:<client_secret>" 
-H 'content-type: application/x-www-form-urlencoded;charset=UTF-8' 
-d "grant_type=password" 
-d "username=<user>" 
-d "password=<password>" 
-d 'scope=urn:opc:idm:t.user.me' 
"https://<stripe>.identity.oraclecloud.com:443/oauth2/v1/token"
    ノート

    ドメインの情報ページに移動して、ドメインに関連付けられたstripeを取得します。「ドメインURL」プロパティの横にある「表示」をクリックして、stripe値を検出します。

    このコマンドは、次のようなJSONレスポンスを返します:

    {"access_token":"eyJ4NXQjUzI...0jxcCw5oR0ajaNw","token_type":"Bearer","expires_in":3600}
  2. JSONからアクセス・トークンをコピーします。例eyJ4NXQjUzI...0jxcCw5oR0ajaNw
  3. このアクセス・トークンを使用してOracle Analytics Cloudインスタンスを作成するには、次のいずれかを実行します:
    • REST API CreateAnalyticsInstance: パラメータidcsAccessTokenでトークン値を指定します。
    • CLI analytics-instance create: トークン値をファイルにコピーし、CLIパラメータ--idcs-access-token-file [filename]でファイルの名前を指定します。