Create appManagementPolicy

名前空間: microsoft.graph

重要

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

appManagementPolicy オブジェクトをCreateします。

この API は、次の国内クラウド展開で使用できます。

グローバル サービス 米国政府機関 L4 米国政府機関 L5 (DOD) 21Vianet が運営する中国

アクセス許可

この API の最小特権としてマークされているアクセス許可またはアクセス許可を選択します。 アプリで必要な場合にのみ、より高い特権のアクセス許可またはアクセス許可を使用します。 委任されたアクセス許可とアプリケーションのアクセス許可の詳細については、「 アクセス許可の種類」を参照してください。 これらのアクセス許可の詳細については、 アクセス許可のリファレンスを参照してください

アクセス許可の種類 最小特権アクセス許可 特権の高いアクセス許可
委任 (職場または学校のアカウント) Policy.Read.ApplicationConfiguration Policy.ReadWrite.ApplicationConfiguration
委任 (個人用 Microsoft アカウント) サポートされていません。 サポートされていません。
アプリケーション Policy.Read.ApplicationConfiguration Policy.ReadWrite.ApplicationConfiguration

カスタム アプリケーション認証方法ポリシーを構成するには、呼び出し元のユーザーに少なくとも アプリケーション管理者 または クラウド アプリケーション管理者ディレクトリ ロールを割り当てる必要があります。

HTTP 要求

POST /policies/appManagementPolicies

要求ヘッダー

名前 説明
Authorization ベアラー {token}。 必須です。 認証と承認の詳細については、こちらをご覧ください。
Content-Type application/json. Required.

重要

createdDateTime null を持つサービス プリンシパルは、2019 年 1 月 1 日に作成されたと見なされます。

要求本文

要求本文で、 appManagementPolicy オブジェクトの JSON 表現を指定します。

appManagementPolicy を作成するときに、次のプロパティを指定できます。

プロパティ 説明
displayName String ポリシーの表示名。 必須です。
説明 String ポリシーの説明。 必須です。
isEnabled ブール値 ポリシーが有効かどうかを示します。 省略可能です。
制限 appManagementConfiguration アプリケーションまたはサービス プリンシパル オブジェクトに適用される制限。 省略可能。

応答

成功した場合、このメソッドは 201 Created 応答ペイロードに新しい appManagementPolicy オブジェクトを含む応答コードを返します。

要求

次の例は要求を示しています。 この要求では、次の設定でアプリ管理ポリシーが作成されました。

  • ポリシーを有効にします。
  • 2019-10-19 の午前 10 時 37 分 (UTC 時刻) 以降に作成されたアプリケーションとサービス プリンシパルの新しいパスワードの作成をブロックします。
  • 2014-10-19 の午前 10 時 37 分 (UTC 時刻) 以降に作成されたアプリケーションに、パスワード シークレットとキー資格情報の有効期間を適用します。
  • 2019-10-19 の午前 10 時 37 分 UTC 時刻の後に作成されたアプリとサービス プリンシパルのパスワード シークレットを、4 日、12 時間、30 分、5 秒未満に制限します。
POST https://graph.microsoft.com/beta/policies/appManagementPolicies

{
    "displayName": "Credential management policy",
    "description": "Cred policy sample",
    "isEnabled": true,
    "restrictions": {
        "passwordCredentials": [
            {
                "restrictionType": "passwordAddition",
                "maxLifetime": null,
                "restrictForAppsCreatedAfterDateTime": "2019-10-19T10:37:00Z"
            },
            {
                "restrictionType": "passwordLifetime",
                "maxLifetime": "P90D",
                "restrictForAppsCreatedAfterDateTime": "2014-10-19T10:37:00Z"
            },
            {
                "restrictionType": "symmetricKeyAddition",
                "maxLifetime": null,
                "restrictForAppsCreatedAfterDateTime": "2019-10-19T10:37:00Z"
            },
            {
                "restrictionType": "symmetricKeyLifetime",
                "maxLifetime": "P30D",
                "restrictForAppsCreatedAfterDateTime": "2014-10-19T10:37:00Z"
            }
        ],
        "keyCredentials": [
            {
                "restrictionType": "asymmetricKeyLifetime",
                "maxLifetime": "P90D",
                "restrictForAppsCreatedAfterDateTime": "2014-10-19T10:37:00Z"
            },
            {
                "restrictionType": "trustedCertificateAuthority",
                "restrictForAppsCreatedAfterDateTime": "2019-10-19T10:37:00Z",
                "certificateBasedApplicationConfigurationIds": [
                    "eec5ba11-2fc0-4113-83a2-ed986ed13743",
                    "bb8e164b-f9ed-4b98-bc45-65eddc14f4c1"
                ],
                "maxLifetime": null
            }
        ]
    }
}

応答

次の例は応答を示しています。

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

{
    "@odata.context": "https://graph.microsoft.com/beta/$metadata#policies/appManagementPolicies/$entity",
    "id": "a4ab1ed9-46bb-4bef-88d4-86fd6398dd5d",
    "displayName": "credential management policy",
    "description": "Lorem ipsum",
    "isEnabled": true,
    "restrictions": {
        "passwordCredentials": [
            {
                "restrictionType": "passwordAddition",
                "maxLifetime": null,
                "restrictForAppsCreatedAfterDateTime": "2019-10-19T10:37:00Z"
            },
            {
                "restrictionType": "passwordLifetime",
                "maxLifetime": "P90D",
                "restrictForAppsCreatedAfterDateTime": "2018-10-19T10:37:00Z"
            }
        ]
    }
}