OCIのAPI認証の設定

ローカル環境をOCIテナンシに接続するには、構成ファイルでAPI認証を設定します。

概要

主なタスク:

コンソールでAPIキーを作成します。
ローカル環境からのAPI認証用のOCI構成ファイルを設定します。
OCI CLIをローカル環境にインストールします。

詳細は、次のリソースを参照してください:

開始する前に

このチュートリアルが正常に実行するには、次の構成が必要です。

サポートされているブラウザ
MacOS、LinuxまたはWindows環境(Windows Subsystem for Linux (WSL))
Python 3がインストールされています。サポートされているPythonのバージョンについては、Python SDKのドキュメントを参照してください。
Python 3がインストールされています。
「チュートリアル用のサンドボックス・ユーザーの作成」チュートリアルを実行し、次の手順を実行します。
- Oracle Mobile Authenticatorアプリケーションを準備します。
- チュートリアルから次の情報を書き留めます。
  - <サンドボックス・ユーザー名>
  - <サンドボックス・ユーザー・パスワード>
  - <tenancy-name>
  - <ドメイン名>
  - <サンドボックス・コンパートメント>

1.APIキーの作成

このチュートリアルでは、コンソールでサンドボックス・ユーザーの秘密キーと公開キーのペアを生成します。コンソールを使用してキー・ペアを追加すると、コンソールによって構成ファイルのプレビュー・スニペットも生成されます。

コンソールにサインインします。「クラウド・アカウント名」に<tenancy-name>を入力し、「次へ」を選択します。
アイデンティティ・ドメインの場合は、<domain-name>を入力します。たとえば、「デフォルト」を選択し、「次へ」を選択します。
<sandbox-username>および<sandbox-user-password>を入力し、「サインイン」を選択します。
Oracle Mobile Authenticatorアプリケーションを開き、<tenancy-name> <sandbox-username>アカウントに対して、生成されたパスコードを取得します。
コンソールの「マルチファクタ認証」ウィンドウで、パスコードを入力して「サインイン」を選択します。
コンソールのホーム・ページが表示されます。
上部のナビゲーション・バーで、「プロファイル」アイコンを選択し、「ユーザー設定」を選択します。
「トークンとキー」を選択します。
「APIキー」で、「APIキーの追加」を選択します。
ダイアログの指示に従ってキーを生成または指定します。

重要

キーを生成する場合は、両方のキーをダウンロードし、キーを安全な場所に保存します。キーを失った場合、キーは再作成できず、新しいキーを再度作成する必要があります。
「追加」を選択します。
構成設定がダイアログに表示されます。構成情報をconfigというローカル環境のファイルにコピーし、そのファイルをセキュア・テキスト・ファイルに保存します。

ヘルプが必要な場合は、API署名の必須キーおよびOCIDsを参照してください。

2. 鍵のアクセス権を変更

前のセクションでキーをダウンロードしたフォルダに移動します。
(オプション)キーの名前を変更します。たとえば、<sandbox-user-private-key.pem>および<sandbox-user-public-key.pem>です。
ターミナルからホーム・ディレクトリに移動します。
.ociディレクトリを作成します。
公開キーと秘密キーを.ociディレクトリに移動し、<path-to-private-key.pem>を書き留めます。
例: <home-directory>/.oci/<sandbox-user-public-key.pem>
ローカル環境で、次のコマンドを使用して秘密キー・ファイルの権限を変更します。
```
chmod 400 <path-to-private-key.pem>
```

4.OCI CLIのインストール

pipを使用して、OCI CLIおよびPython SDKをインストールします:
```
pip install oci-cli
```
必要なライブラリはすべてインストールされます。
OCI CLIがインストールされていることを確認します。次のコマンドを入力します。
```
pip list
```
このコマンドは、oci-cliを含むインストール済パッケージをリストします。たとえば:
```
oci-cli                  <version>
```

4. ローカル構成ファイルの作成

.ociディレクトリから、コマンドtouch configを入力します。
前の項でコピーしたAPIキー構成データをconfigファイルに貼り付けます。
configファイルの例。
```
[DEFAULT]
user=<ocid1.user.oc1..xxx>
fingerprint=<xx:xx:xx:xx>
tenancy=<ocid1.tenancy.oc1..xxx>
region=us-chicago-1
key_file=<path-to-private-key.pem>       
```
この構成は、[Default]で指定されたDefaultプロファイル用です。

5. 設定のテスト

OCI CLIが構成ファイルを使用してテナンシに接続していることを確認します。

OCI CLIがインストールされていることを確認します。
```
oci
```
このコマンドは、CLIで使用可能なコマンドを一覧表示します。
構成ファイルが機能することを確認します。
```
oci os ns get
```
このコマンドは、テナンシのネームスペースを取得します。
```
oci iam region list
```
このコマンドは、テナンシで使用可能なリージョンをリストします。

Oracle Cloud Infrastructureドキュメント