CLI/APIでOracle Analytics Cloudインスタンスを作成するために、アクセストークンを生成する方法

このシリーズの他の記事は、[オラクル・クラウドの個人ブログ一覧 ](https://qiita.com/letian/items/10152a4fec813c1b7d98)からご覧いただけます。

# 初めに
<strong>CLI/REST API</strong>、或いは<strong>TerraForm</strong>を利用して、Oracle Analytics Cloud (OAC)インスタンスを作成する際には、アクセストークンが必要です。このブログでは、アクセストークンの作成方法についてご紹介します。

__ステップ__
- [1. 統合アプリケーションの作成](#1-統合アプリケーションの作成)
- [2. アプリケーションのアクティブ化](#2-アプリケーションのアクティブ化)
- [3. トークンのダウンロード](#3-トークンのダウンロード)

# 1. 統合アプリケーションの作成
プロフィール > アイデンティティ・ドメイン
<img src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1121622/ce25c217-2ae2-45e8-7544-17d59074dfcd.png", width="300">

統合アプリケーション >  アプリケーションの追加
<img src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1121622/b7b434cb-7860-c72b-7772-71e5fa87e64d.png", width="500">

「機密アプリケーション」を選択し、「ワークフローの起動」をクリックする。
<img src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1121622/20dd8883-1805-2047-a943-32d39a456cc8.png", width="500">

名前を入力し、次をクリックする。
<img src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1121622/ccb0bf7d-d623-2854-2c1a-a7c30fd35d59.png", width="400">

「このアプリケーションをクライアントとして今すぐ構成します」を選択し、以下のタイプをチェックする。
- リソース所有者 (Resource Owner)
- クライアント資格証明 (Client Credentials)
- JAWアサーション (JWT Assertion)
<img src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1121622/bbafeb62-b075-1682-7d12-63c6e90dd5f5.png", width="500">
- 「許可された操作」に、<strong>代理</strong>（On behalf Of）をチェックする。
- 「トークン発行ポリシー」に、「リソースの追加」をチェックし、「スコープの追加」をクリックすると、スコープの追加画面がポップアップされる。
<img src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1121622/33405279-95fb-7aae-53fe-c4a4ee655fbb.png", width="600">
一覧から「AUTOANALLYTICS」を選択し、「追加」をクリックする。
<img src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1121622/0402c6f6-acdd-4a95-7268-ae5cc5c57150.png", width="600">
スコープを追加した後、「次」をクリックする。
<img src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1121622/4ae1dca2-cd4b-784c-1785-cdf88af3f29a.png", width="600">

Web層ポリシーのところに、デフォルトの「スキップして後で実行」でよい。「終了」をクリックし、作成を完了する。
<img src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1121622/d72239c7-99f8-a556-738b-83ca666b8cf0.png", width="500">

# 2. アプリケーションのアクティブ化
アプリケーションの詳細画面に、「アクティブ化」をクリックする。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1121622/9f6dae84-99db-9727-e2f1-5ef710694b95.png)

確認画面が表示されたら、ボタンをクリックして続行する。
<img src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1121622/dc38f14b-9752-d986-28ce-e38c13544b6e.png", width="350">

アクティブの状態に変わるのを確認する。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1121622/dd6d440d-022c-1103-19cb-858c23554e16.png)

# 3. トークンのダウンロード
__ステップ__
(1) アプリケーションの詳細情報の下部に、「アクセス・トークン」をクリックする。
(2) 「その他のAPIの呼び出し」を選択する。
(3) 「AUTOANALYTICS」をチェックする。
(4) 「トークンのダウンロード」をクリックし、ファイルをダウンロードする（デフォルトの名前：<strong>tokens.tok</strong>）。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1121622/2ef0642e-3a18-35a0-d345-b290c8106d51.png)
※、アプリケーションが「<strong>非</strong>アクティブ」の状態であれば、「アクセス・トークン」の選択肢が表示されません。

トークンファイルの中身は次のようになります。有効期間は、<strong>1時間</strong>(3600秒)です。
{"access_token":"\<token_string>","token_type":"Bearer","expires_in":3600}

:::note
REST APIを使用してOACスナップショットを作成する際には、アクセストークンが必要ですが、既存のOACアプリケーションを利用できます。新たにアプリケーションを作成する必要はありません。
:::

以上です。

----
__参考資料__
My Oracle Support (MOS)ドキュメント
[How To Generate The IDCS Access Token Required To Create An OAC (OCI Gen2) Instance Using CLI/REST API Methods (Doc ID 2608610.1)](https://support.oracle.com/knowledge/Oracle%20Cloud/2608610_1.html)