次の方法で共有


appManagementPolicy を作成する

名前空間: microsoft.graph

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

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

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

アクセス許可

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

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

重要

職場または学校アカウントを使用した委任されたシナリオでは、サインインしているユーザーに、サポートされているMicrosoft Entraロールまたはサポートされているロールのアクセス許可を持つカスタム ロールを割り当てる必要があります。 この操作では、次の最小特権ロールがサポートされています。

  • クラウド アプリケーション管理者
  • アプリケーション管理者

HTTP 要求

POST /policies/appManagementPolicies

要求ヘッダー

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

重要

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

要求本文

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

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

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

応答

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

要求

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

  • ポリシーを有効にします。
  • 2019 年 10 月 19 日以降に作成されたアプリケーションとサービス プリンシパルの新しいパスワードの作成を、UTC 時刻の午前 10 時 37 分にブロックします。
  • 2014 年 10 月 19 日以降に作成されたアプリとサービス プリンシパルのパスワード シークレットを UTC 時刻の午前 10 時 37 分から 90 日未満に制限します。
  • 非DefaultUriAddition 制限を無効にします。 つまり、このポリシーが適用されたアプリは、テナントの既定のポリシーで通常ブロックされる場合でも、アプリに新しい既定以外の識別子 URI を追加できます。
  • その他の制限は指定しません。 これは、このポリシーが適用されたアプリ/サービス プリンシパルに対するこれらの制限の動作は、テナントの既定のポリシーが構成されている場合にフォールバックすることを意味します。
POST https://graph.microsoft.com/v1.0/policies/appManagementPolicies

{
    "displayName": "Credential management policy",
    "description": "Cred policy sample",
    "isEnabled": true,
    "restrictions": {
        "passwordCredentials": [
            {
                "restrictionType": "passwordAddition",
                "state": "enabled",
                "maxLifetime": null,
                "restrictForAppsCreatedAfterDateTime": "2019-10-19T10:37:00Z"
            },
            {
                "restrictionType": "passwordLifetime",
                "state": "enabled",
                "maxLifetime": "P90D",
                "restrictForAppsCreatedAfterDateTime": "2014-10-19T10:37:00Z"
            },
            {
                "restrictionType": "symmetricKeyAddition",
                "state": "enabled",
                "maxLifetime": null,
                "restrictForAppsCreatedAfterDateTime": "2019-10-19T10:37:00Z"
            },
            {
                "restrictionType": "symmetricKeyLifetime",
                "state": "enabled",
                "maxLifetime": "P90D",
                "restrictForAppsCreatedAfterDateTime": "2014-10-19T10:37:00Z"
            }
        ],
        "keyCredentials": [],
        "applicationRestrictions": {
            "identifierUris": {
                "nonDefaultUriAddition": {
                    "state": "disabled",
                    "restrictForAppsCreatedAfterDateTime": null,
                    "excludeAppsReceivingV2Tokens": true,
                    "excludeSaml": true
                }
            }
        }
    }
}

応答

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

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

{
    "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#policies/appManagementPolicies/$entity",
    "id": "a4ab1ed9-46bb-4bef-88d4-86fd6398dd5d",
    "displayName": "credential management policy",
    "description": "Lorem ipsum",
    "isEnabled": true,
    "restrictions": {
        "passwordCredentials": [
            {
                "restrictionType": "passwordAddition",
                "state": "enabled",
                "maxLifetime": null,
                "restrictForAppsCreatedAfterDateTime": "2019-10-19T10:37:00Z"
            },
            {
                "restrictionType": "passwordLifetime",
                "state": "enabled",
                "maxLifetime": "P90D",
                "restrictForAppsCreatedAfterDateTime": "2018-10-19T10:37:00Z"
            },
            {
                "restrictionType": "symmetricKeyAddition",
                "state": "enabled",
                "maxLifetime": null,
                "restrictForAppsCreatedAfterDateTime": "2019-10-19T10:37:00Z"
            },
            {
                "restrictionType": "symmetricKeyLifetime",
                "state": "enabled",
                "maxLifetime": "P90D",
                "restrictForAppsCreatedAfterDateTime": "2014-10-19T10:37:00Z"
            }
        ],
        "keyCredentials": [],
        "applicationRestrictions": {
            "identifierUris": {
                "nonDefaultUriAddition": {
                    "state": "disabled",
                    "restrictForAppsCreatedAfterDateTime": null,
                    "excludeAppsReceivingV2Tokens": true,
                    "excludeSaml": true
                }
            }
        }
    }
}