REST APIの手動構成

Avatar
Nerdio Product Support

このトピックでは、 Nerdio Manager

Nerdio Manager

既定では、 Nerdio Manager

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

  1. Nerdio Manager で、System > Settings > 統合 エリアに移動します。

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

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

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

注記

注: 次の手順は、デフォルト名である Nerdio Managerアプリ登録を参照しています。異なる名前を持っている場合は、 アプリサービス環境変数またはアプリ構成からアプリケーションIDを見つけることができます。地域HAが構成されている場合は、AzureAD:ClientID Nerdio Manager

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

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

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

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

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

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

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

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

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

    注記

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

    image2061.png

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

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

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

注記

注意: アプリケーションID URIの例は api://g0cb288e-ff16-1861-9393-50219a19453c です。

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

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

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

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

    image2053.png

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

    image2054.png

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

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

  7. REST APIタイルで、 資格情報の隣にある情報アイコン

    image2038.png

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

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

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

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

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

    image2039.png

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

    image2055.png

  3. 次の情報を入力してください：

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

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

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

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

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

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

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

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

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

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

    image2062.png

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

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

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

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

    ヒント

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

    image2056.png

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

    image2042.png

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

    注記

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

    image2041.png

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

    image2043.png

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

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

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

    • タイプこれを 役割 に変更します。

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

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

    image2066.png

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

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

    image2064.png

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

    image2047.png

  17. 次の情報を入力してください：

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

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

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

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

    image2050.png

Nerdio Manager

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

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

  1. 数分待った後、 Nerdio Manager

  2. [System] で、[Settings] > [統合] に移動します。

    image2057.png

  3. REST API エリアで、認証情報 の隣にある 表示 を選択してください。

    image2049.png

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

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

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

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

    image2051.png

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

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

PowerShellをテストする

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

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

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

  • テナントIDこれはREST API認証情報からコピーできます。

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

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

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

    image2058.png
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. 利用可能なワークスペースのリストが表示されることを確認してください。

    image2059.png

Postman

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

この記事は役に立ちましたか？

1人中1人がこの記事が役に立ったと言っています
他にご質問がございましたら、リクエストを送信してください

関連記事

コメント (0件のコメント)

記事コメントは受け付けていません。