REST APIの手動構成

このトピックでは、Nerdio Managerで使用するためのREST APIを手動で設定する方法について説明します。

Nerdio Managerの既定REST APIステータス

既定では、Nerdio Managerをインストールすると、REST APIは無効になります。

REST APIのステータスを確認するには：

1. [Nerdio Manager設定] > [環境] に移動し、[統合] タブを選択します。

2. REST APIタイルを展開します。現在のステータストグルは、REST APIが現在有効か無効かを示します。

Nerdio-nmw-appマニフェストを更新する

必要な情報でNerdio-nmw-appマニフェストファイルを更新する必要があります。

Nerdio-nmw-appマニフェストを更新するには：

1. Azureポータルで、アプリケーション登録に移動します。

2. Nerdio-nmw-appを検索して選択します。

3. 概要セクションで、アプリケーション（クライアント）IDの値をコピーします。

4. 管理ブレードで、マニフェストを選択して、Microsoft GraphアプリマニフェストJSONファイルを開きます。

5. ファイルのapiセクションに移動し、次の行を追加します：

   "identifierUris": ["api://<app_id>"],

6. "accessTokenAcceptedVersion"の値をnullから2に変更します。

   完了したら、オープニング

   注意: マニフェストファイルは次のようになります:

   

7. マニフェストファイルを保存してください。

アプリケーションID URIを追加してください。

アプリケーションID URIが設定されていない場合は、追加する必要があります。

アプリケーションID URIを追加するには:

1. Azure ポータルで、アプリケーション登録に移動します。

2. Nerdio-nmw-appを検索して選択します。

3. 概要を選択してください。

   

4. アプリケーションID URIを追加を選択してください。

   

5. 追加を選択し、その後 保存を選択してください。

6. これらの変更がAzureポータルに追加され保存されると、Nerdio Managerで 設定 > 統合に移動します。

7. REST APIタイルで、資格情報の隣にある情報アイコン を選択してください。

   

8. この情報ポップアップを閉じて、REST APIの設定を完了するために以下の手順に従ってください。

新しいアプリケーション登録を作成してください。

次のステップは、Azureポータルで新しいアプリケーション登録を作成し、設定することです。

新しいアプリケーション登録を作成するには:

1. Azure ポータルで、アプリケーション登録に移動します。

   

2. [+ 新規登録] を選択します。

   

3. 次の情報を入力します:

   • 名前: 新しいアプリケーション登録の名前を入力してください。

   • 他のパラメータはデフォルトのままにしてください。

4. 必要な情報をすべて入力したら、[登録] を選択します。

   アプリケーションが登録され、新しく作成したアプリケーションの設定に移動します。

新しいアプリケーション登録を更新してください。

次のステップは、新しいアプリケーション登録を更新することです。

新しいアプリケーション登録を更新するには:

1. Azure ポータルで、アプリケーション登録に移動します。

2. Nerdio-nmw-appを検索して選択します。

3. [管理] ブレードで、[アプリの役割] を選択します。

   

4. 必要な[RestClient] IDをコピーします。これは私たちが必要とする[NME_ID]です。

5. アプリケーション登録に戻ります。

6. 新しく作成したアプリケーション登録（私たちの例ではRESTApi）を選択します。

7. [管理] ブレードで、[マニフェスト] を選択します。

   ヒント: 変更を加える前に、間違いがあった場合に備えてマニフェストのコピーをダウンロードしてください。

   

8. セクションタグを見つけます。これは次のようなタグになります：

   

9. ブラケット内に次の内容を追加します "NMW_REST_API_CLIENT:<app_id>"

   注意: 修正されたタグは次のようになります:

   

10. "requiredResourceAccess"を見つけます。これは修正前に次のようになります:

    

11. 次の変更を加えます:

    • resourceAppId: これは文書全体で使用した[App_id]です。

    • id: これは前のステップでコピーした[NME_ID]です。

    • タイプ: これを[ロール]に変更します。

12. マニフェストファイルを保存してください。

13. [管理] ブレードで、[API 権限] を選択します。

    

14. 管理者の同意を付与して

15. [管理] ブレードで、[証明書とシークレット] を選択します。

    

16. [+ 新しいクライアントシークレット] を選択します。

    

17. 次の情報を入力します:

    • 説明: クライアントシークレットの説明を入力します。

    • 期間: ドロップダウンリストから希望の期間を選択します。

18. すべての希望する情報を入力したら、[OK] を選択します。

19. 後で必要なクライアントシークレットの値をコピーして保存します。

    

Nerdio ManagerでREST APIの状態を確認してください。

Azureポータルで上記の手順を完了したら、、REST APIの状態を確認する前に数分待ってください（重要）。その後、Nerdio Managerで状態を確認します。

REST APIの状態を確認するには：

1. 数分待った後、Nerdio Managerでセッションを更新してください。

2. [設定] > [統合] に移動します。

   

3. REST APIタイルのCredentialsの隣にある表示を選択してください。

   

4. 認証情報が上記のサンプルのように見えることを確認してください。

5. 認証情報のポップアップウィンドウを閉じるには、OKを選択してください。

6. Documentationの隣にあるswaggerを選択してください。

7. Swaggerページの右上隅で、Authorizeを選択してください。

   

8. 以前に保存したクライアントシークレットの値を貼り付けてください。

9. Authorizeを選択してください。

PowerShellをテストする

REST APIをテストするために、以下の変数が必要です：

• Client_Secret：これは以前に保存したクライアントシークレットです。

• Client_ID：これはREST API認証情報からコピーできます。

• Tenant_ID：これはREST API認証情報からコピーできます。

• NME_Scope：これはREST API認証情報からコピーできます。

• NME_URL：これはNerdio Managerウェブアプリへのリンクです。

• Sub_ID：これは設定 > Azure環境 > Azureサブスクリプションタイルからコピーできます。

  

PowerShellスクリプトをテストするには：

1. 以下のコマンドを使用して、先ほどコピーした変数を使ってPowerShellスクリプトを作成し、保存してください。この例では、REST-API.ps1を保存しています。

   # NerdioManager PowerShellモジュールをインストールします。

   Install-Module -Name NerdioManagerPowerShell

   # いくつかの変数を設定します。

   # Client_Secretは、新しく作成したアプリ登録のためのクライアントシークレットです。

   $NMEClientSecret = "<Client_Secret>"

   # Client_IDは、NME REST API認証情報からコピーできます。

   $NMEClientId = "Client_ID"

   # Tenant_IDは、NME REST API認証情報からコピーできます。

   $NMETenantId = "<Tenant_ID>"

   # NME_Scopeは、NME REST API認証情報からコピーできます。

   $NMEScope = "<NME_Scope>"

   # NME_URLは、NMEウェブアプリへのリンクです。

   $nMEuRI = "<NME_URL>"

   # Sub_IDは、NME > 設定 > Azure環境からコピーできます。

   $NMWSubscriptionId = "<Sub_ID>"

   接続

   Connect-NME -ClientId $NmeClientId -ClientSecret $NmeClientSecret -TenantId $NmeTenantId -ApiScope $NmeScope -NmeUri $NmeUri

   # 利用可能なワークスペースのリストを表示します。

   Get-nmeworkspace

2. 管理者権限でPowerShellを開き、REST-API.ps1スクリプトを保存した場所に移動してください。

3. 以下のコマンドを実行してください：

   Set-ExecutionPolicy -ExecutionPolicy Unrestricted -Scope CurrentUser

    

   .\REST-API.ps1

4. プロンプトが表示されたら、はいまたはすべてに対してはいを選択してください。

5. 利用可能なワークスペースのリストが表示されることを確認してください。

   

Postman

詳細については、REST APIエンドポイントの実装を参照してください。