servicePrincipal: createPasswordSingleSignOnCredentials

名前空間: microsoft.graph

重要

Microsoft Graph のバージョンの /beta API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 API が v1.0 で使用できるかどうかを確認するには、 バージョン セレクターを使用します。

ユーザーまたはグループのパスワードを使用してシングル サインオン資格情報を作成します。

アクセス許可

この API を呼び出すには、次のいずれかのアクセス許可が必要です。アクセス許可の選択方法などの詳細については、「アクセス許可」を参照してください。

アクセス許可の種類 アクセス許可 (特権の小さいものから大きいものへ)
委任 (職場または学校のアカウント) Application.ReadWrite.All および Directory.Read.All、Directory.ReadWrite.All
委任 (個人用 Microsoft アカウント) サポートされていません。
アプリケーション Application.ReadWrite.All および Directory.Read.All、Directory.ReadWrite.All

注意

ユーザーは自分の資格情報を作成できます。 次の役割を持つサービス プリンシパルの所有者と管理者は、任意のユーザーまたはグループの資格情報を作成できます。GlobalAdministrator、ApplicationAdministrator、CloudApplicationAdministrator。 詳細については、「Directory roles」を参照してください

HTTP 要求

POST /servicePrincipals/{id}/createPasswordSingleSignOnCredentials

要求ヘッダー

名前 説明
Authorization ベアラー {token}。必須。
Content-Type application/json. Required.

要求本文

要求本文で、次のパラメーターを含む JSON オブジェクトを指定します。

パラメーター 説明
id String この資格情報セットが属するユーザーまたはグループの ID。
資格情報 資格情報 のコレクション 完全なサインイン フローを定義する資格情報オブジェクトの一覧。

応答

成功した場合、このメソッドは 200 OK 応答コードと、応答本文の新しい passwordSingleSignOnCredentialSet オブジェクトを返します。

要求

要求の例を次に示します。

POST https://graph.microsoft.com/beta/servicePrincipals/{id}/createPasswordSingleSignOnCredentials
Content-type: application/json

{
  "id": "5793aa3b-cca9-4794-679a240f8b58",
  "credentials": [
    {
      "fieldId": "param_username",
      "value": "myusername",
      "type": "username"
    },
    {
      "fieldId": "param_password",
      "value": "pa$$w0rd",
      "type": "password"
    }
  ]
}

応答

応答の例を次に示します。

注: ここに示す応答オブジェクトは、読みやすさのために短縮されている場合があります。

HTTP/1.1 200 OK
Content-type: application/json

{
  "id": "5793aa3b-cca9-4794-679a240f8b58",
  "credentials": [
    {
      "fieldId": "param_username",
      "value": "myusername",
      "type": "username"
    },
    {
      "fieldId": "param_password",
      "value": null,
      "type": "password"
    }
  ]
}