API認証情報の生成と管理

新しい認証情報の作成 

[ API認証情報]ページで、次の手順を実行して新しい認証情報を作成します。 

1. [ 新しい認証情報]をクリックします。[ 新しい認証情報]ウィンドウが表示されます。 
2. 認証情報の名前を入力します。 

   認証情報の名前を簡単に認識できるようにするため、Druva製品と統合する予定のアプリケーションまたはツールの名前と一致するように認証情報に名前を付けることをお勧めします。

3. ネットワーク制限を適用するには、ネットワーク制限の適用に記載されている手順を実行します。 
4. 認証の制限を適用するには、提供の手順を実行し、許可の制限を適用します。
5. 保存をクリックします。[ 認証情報の詳細]ウィンドウが表示されます。
6.  アイコンをクリックして、自動生成されたClient IDと  Secret Keyをクリップボードにコピーし  ます  。

   Client IDと  Secret Keyは、ユーザー名とパスワードに相当します。すべてのDruva APIにアクセスでき、次にDruva製品内に保存されているデータにアクセスできます。Client IDと  Secret Key は、許可されていないソースと共有しないでください。

   • 秘密キーは、サードパーティアプリケーションを認証してアクセストークンを生成するために必要です。
   •  手順3に従ってシークレットキーを コピーしない場合は、関連付けられた認証情報の新しいシークレットキーを生成する必要があり  ます。
   • APIの使用状況とアクティビティは、監査証跡を通じて追跡できます。監査証跡には、API認証情報の詳細、ターゲットAPI、およびユーザーの詳細が、使用時間とともに表示されます。 
7. ワークフローの詳細については、API統合ワークフローを参照してください。

ネットワーク制限の適用

では、ネットワークの制限の機能は、APIを介して、APIの認証情報やデータへのアクセスの利用を確保するためのオプションがあります。ネットワークの制限の機能は、特定のIPアドレスまたはIPアドレスの範囲からのAPIの使用を制限しています。

[ API認証情報]ページで、次の手順を実行してネットワーク制限を適用します。 

1. ネットワーク制限を適用する認証情報の名前をクリックします。 
2. [ 編集]をクリックします。[ 認証情報の編集]  ウィンドウが表示されます。
3. [  制限を有効にする]  チェックボックスをオンにします。
4. [IP]ボックスに、企業ネットワークのパブリックIPを入力します。
   IPアドレスは次の形式で指定できます。

192.0.2.123

192.0.2.1〜192.0.3.254

192.0.2.1-192.0.3.254、192.0.7.1、
192.100.0.1-192.100.0.254

認可制限の適用

Authorization Restriction (認可制限) 機能は、API認証情報の認可にロールベース制限を適用するオプションです。

これにより、API認証情報を使用してアプリケーションを設定する管理者は、これらAPI認証情報に割り当てられたロールに基づく情報のみを表示できます。 

API CredentialsページでDruva inSyncとPhoenix全体でAPI認証情報の認可制限を適用するには、次の手順を実行します。

1. ネットワーク制限を適用する認証情報の名前をクリックします。 
2. [ Edit ] をクリックします。[ Edit Credentials ] ウィンドウが表示されます。
3. Druva クラウド管理者のみにAPI認証情報を許可する場合は、Druva クラウド管理者を選択します。
4. 選択して製品管理を Druvaインシンク、フェニックスから該当する製品の管理者を選択します。
5. 保存をクリックします。

新しいSecret Keyの生成

Secret Key を紛失、盗難、または新しい認証情報 (New Credential) 生成時にコピー失敗した場合、新しい Secret Key を生成する必要があります。

<重要>  

• 現在使用中のAPI認証情報に対して新しいSecret Keyを生成すると、古いSecret Key に関連付けられているすべてのアクティブなトークンと古い Secret Key は無効になります。
• 古いSecret Keyを使用した認証に対する後続のコール要求は認証されず、応答として不正な例外 (Unauthorized Exception) を受信します。古いAPI認証情報を使用したAPI連携は、新しいSecret Keyで更新されない限り失敗します。

API Credentials ページで新しいSecret Keyを生成するには次の手順を実行します。

1. 新しいSecret Keyを生成する予定の認証情報名をクリックします。 
2. その他のオプション   ボタンをクリックし、[ Generate New Secret Key ] を選択します。 
3. 確認ウィンドウで [ Continue ]をクリックして新しいSecret Keyを生成します。
4.  アイコンをクリックして、自動生成されたClient ID と Secret Key をクリップボードにコピーします。

既存認証情報の名前変更

[ API Credentials ] ページで次の手順を実行して既存認証情報の名前を変更します。 

1. 名前を変更する認証情報の名前をクリックします。
2. [ Edit ] ボタンをクリックします。[ Edit Credentials ] ウィンドウが表示されます。 
3. 選択した認証情報の新しい名前を入力します。
4. [ Save ] をクリックします。 

既存認証情報の削除

<重要>

認証情報を削除すると、その認証情報によって作成されたすべてのアクティブなトークンが即座に利用できなくなります。この認証情報を使用する以降すべてのコールは、応答として不正な例外 (Unauthorized Exception) を受信します。 

[ API Credentials ] ページで次の手順を実行して認証情報を削除します。 

1. 削除する認証情報の名前をクリックします。 
2. その他のオプション  ボタンをクリックし、[ Delete Credential ] を選択します。 
3. 確認ウィンドウで、[ Delete ] をクリックして認証情報を削除します。