Microsoft.Graph アプリケーション
重要
Microsoft Graph の /beta
バージョンの API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 v1.0 で API を使用できるかどうかを確認するには、バージョン セレクターを使用します。
アクセス許可
この API の最小特権としてマークされているアクセス許可またはアクセス許可を選択します。 アプリで必要な場合 、より高い特権またはアクセス許可を使用します。 委任されたアクセス許可とアプリケーションのアクセス許可の詳細については、「 Permission の種類」を参照してください。 これらのアクセス許可の詳細については、 アクセス許可のリファレンスを参照してください。
Note
個人の Microsoft アカウントのアクセス許可を使用して、Bicep ファイルで宣言された Microsoft Graph リソースをデプロイすることはできません。
アクセス許可の種類 | 最小限の特権アクセス許可 | 高い特権のアクセス許可 |
---|---|---|
委任 (勤務先または学校アカウント) | Application.ReadWrite.All | 使用できません。 |
委任 (個人用 Microsoft アカウント) | Application.ReadWrite.All | 使用できません。 |
アプリケーション | Application.ReadWrite.OwnedBy | Application.ReadWrite.All |
リソース形式
Microsoft.Graph/applications リソースを作成するには、次の Bicep をテンプレートに追加します。
resource symbolicname 'Microsoft.Graph/applications@beta' = {
api: {
acceptMappedClaims: bool
knownClientApplications: 'string'
oauth2PermissionScopes: [
{
adminConsentDescription: 'string'
adminConsentDisplayName: 'string'
id: 'string'
isEnabled: bool
type: 'string'
userConsentDescription: 'string'
userConsentDisplayName: 'string'
value: 'string'
}
]
preAuthorizedApplications: [
{
appId: 'string'
permissionIds: [
'string'
]
}
]
requestedAccessTokenVersion: int
}
appRoles: [
{
allowedMemberTypes: [
'string'
]
description: 'string'
displayName: 'string'
id: 'string'
isEnabled: bool
value: 'string'
}
]
authenticationBehaviors: {
blockAzureADGraphAccess: bool
removeUnverifiedEmailClaim: bool
requireClientServicePrincipal: bool
}
defaultRedirectUri: 'string'
description: 'string'
disabledByMicrosoftStatus: 'string'
displayName: 'string'
groupMembershipClaims: 'string'
identifierUris: [
'string'
]
info: {
marketingUrl: 'string'
privacyStatementUrl: 'string'
supportUrl: 'string'
termsOfServiceUrl: 'string'
}
isDeviceOnlyAuthSupported: bool
isFallbackPublicClient: bool
keyCredentials: [
{
customKeyIdentifier: 'string'
displayName: 'string'
endDateTime: 'string'
key: 'string'
keyId: 'string'
startDateTime: 'string'
type: 'string'
usage: 'string'
}
]
logo: 'string'
notes: 'string'
optionalClaims: {
accessToken: [
{
additionalProperties: [
'string'
]
essential: bool
name: 'string'
source: 'string'
}
]
idToken: [
{
additionalProperties: [
'string'
]
essential: bool
name: 'string'
source: 'string'
}
]
saml2Token: [
{
additionalProperties: [
'string'
]
essential: bool
name: 'string'
source: 'string'
}
]
}
parentalControlSettings: {
countriesBlockedForMinors: [
'string'
]
legalAgeGroupRule: 'string'
}
passwordCredentials: [
{
displayName: 'string'
endDateTime: 'string'
keyId: 'string'
startDateTime: 'string'
}
]
publicClient: {
redirectUris: [
'string'
]
}
requestSignatureVerification: {
allowedWeakAlgorithms: 'string'
isSignedRequestRequired: bool
}
requiredResourceAccess: [
{
resourceAccess: [
{
id: 'string'
type: 'string'
}
]
resourceAppId: 'string'
}
]
samlMetadataUrl: 'string'
serviceManagementReference: 'string'
servicePrincipalLockConfiguration: {
allProperties: bool
credentialsWithUsageSign: bool
credentialsWithUsageVerify: bool
isEnabled: bool
tokenEncryptionKeyId: bool
}
signInAudience: 'string'
spa: {
redirectUris: [
'string'
]
}
tags: [
'string'
]
tokenEncryptionKeyId: 'string'
uniqueName: 'string'
verifiedPublisher: {
addedDateTime: 'string'
displayName: 'string'
verifiedPublisherId: 'string'
}
web: {
homePageUrl: 'string'
implicitGrantSettings: {
enableAccessTokenIssuance: bool
enableIdTokenIssuance: bool
}
logoutUrl: 'string'
oauth2AllowImplicitFlow: bool
redirectUris: [
'string'
]
redirectUriSettings: [
{
index: int
uri: 'string'
}
]
}
windows: {
redirectUris: [
'string'
]
}
}
プロパティ値
カスタムライン
名前 | Description | Value |
---|---|---|
api | Web API を実装するアプリケーションの設定を指定します。 | MicrosoftGraphApiApplication |
apiVersion | リソース API のバージョン | 'beta' (ReadOnly) |
appId | Microsoft Entra ID によって割り当てられるアプリケーションの一意識別子。 NULL 値は許可されません。 読み取り専用です。 代替キー | string (ReadOnly) |
appRoles | アプリケーションに対して定義されているロールのコレクション。 アプリ ロールの割り当てでは、これらのロールを他のアプリケーションに関連付けられているユーザー、グループ、またはサービス プリンシパルに割り当てることができます。 NULL 値は許可されません。 | MicrosoftGraphAppRole[] |
authenticationBehaviors | アプリケーションに設定された認証動作のコレクション。 認証動作は既定では設定されておらず、明示的に有効 (または無効) にする必要があります。 認証動作の詳細については、「アプリケーション認証を管理するBehaviors」を参照して、ユーザーの識別または承認のために電子メール要求が未確認で使用されないようにします。 | MicrosoftGraphAuthenticationBehaviors |
証明書 | アプリケーションの認定状態を指定します。 | MicrosoftGraphCertification (ReadOnly) |
createdDateTime | アプリケーションが登録された日時。 DateTimeOffset 型は日時の情報を表し、ISO 8601 形式を使用して、常に UTC 時間を示します。 たとえば、2014 年 1 月 1 日の午前 0 時 (UTC) は 2014-01-01T00:00:00Z です。 読み取り専用 | string (ReadOnly) |
defaultRedirectUri | 既定のリダイレクト URI。 SAML フローと OIDC フローのサインイン要求に明示的なリダイレクト URI が指定されていない場合、Microsoft Entra ID はこのリダイレクト URI にトークンを送信します。 また、Microsoft Entra ID は、SAML IdP によって開始されるシングル サインオンで、この既定の URI にトークンを送信します。 この値は、アプリケーション用に構成されているリダイレクト URI のいずれかと一致する必要があります。 | string |
deletedDateTime | このオブジェクトが削除された日時。 オブジェクトが削除されていない場合は常に null。 | string (ReadOnly) |
description | エンド ユーザーにアプリケーション オブジェクトの説明を提供するフリー テキスト フィールド。 最大許容サイズは 1,024 文字です | string |
disabledByMicrosoftStatus | Microsoft が登録済みアプリケーションを無効にしたかどうかを指定します。 使用可能な値は、null (既定値)、NotDisabled、DisabledDueToViolationOfServicesAgreement (疑わしい、虐待的、悪意のあるアクティビティ、または Microsoft サービス契約違反が含まれる可能性がある理由) です。 | string |
displayName | アプリケーションの表示名 | string (必須) |
groupMembershipClaims | アプリケーションが想定するユーザーまたは OAuth 2.0 アクセス トークンで発行されたグループ要求を構成します。 この属性を設定するには、次のいずれかの文字列値を使用します。None、SecurityGroup (セキュリティ グループと Microsoft Entra ロールの場合)、All (サインインしているユーザーがメンバーであるすべてのセキュリティ グループ、配布グループ、および Microsoft Entra ディレクトリ ロールを取得します)。 | string |
ID | エンティティの一意識別子。 読み取り専用です。 | string (ReadOnly) |
identifierUris | アプリ ID URI とも呼ばれるこの値は、アプリケーションがリソース アプリとして使用されるときに設定されます。 identifierUris は、API のコードで参照するスコープのプレフィックスとして機能し、グローバルに一意である必要があります。 指定されている既定値 (api://<appId> 形式) を使うか、https://contoso.com/api のようにより読みやすい URI を指定できます。 有効な identifierUris パターンとベスト プラクティスの詳細については、Microsoft Entra アプリケーション登録のセキュリティに関するベスト プラクティスを参照してください。 NULL 値は許可されません |
string[] |
info | アプリケーションの基本的なプロファイル情報 (マーケティング、サポート、サービス利用規約、プライバシーに関する声明の URL など)。 サービス利用規約とプライバシーに関する声明は、ユーザーの同意エクスペリエンスからユーザーに提示されます。 詳細については、「方法: 登録済みの Microsoft Entra アプリのサービス利用規約とプライバシーに関する声明を追加する」を参照してください。 | MicrosoftGraphInformationalUrl |
isDeviceOnlyAuthSupported | このアプリケーションがデバイス認証をユーザーなしで実行できるかどうかを指定します。 既定値は false です。 | [bool] |
isFallbackPublicClient | モバイル デバイスで実行されているインストール済みアプリケーションなど、フォールバック アプリケーション タイプをパブリック クライアントとして指定します。 既定値は false です。これは、フォールバック アプリケーションの種類が Web アプリなどの機密クライアントであることを意味します。 Microsoft Entra ID でクライアント アプリケーションの種類を特定できないシナリオがあります。 たとえば、リダイレクト URI を指定せずにアプリケーションが構成されている ROPC フローです。 このような場合、Microsoft Entra ID は、このプロパティの値に基づいてアプリケーションの種類を解釈します。 | [bool] |
keyCredentials | アプリケーションに関連付けられているキー資格情報のコレクション。 NULL 値は許可されません | MicrosoftGraphKeyCredential[] |
ロゴ | アプリケーションのメイン ロゴ。 NULL 値は許可されません。 | string |
注 | アプリケーションの管理に関連する注意事項。 | string |
optionalClaims | アプリケーション開発者は、Microsoft Entra アプリケーションでオプションの要求を構成して、Microsoft セキュリティ トークン サービスによってアプリケーションに送信される要求を指定できます。 詳細については、「方法: アプリに省略可能な要求を提供する」を参照してください。 | MicrosoftGraphOptionalClaims |
parentalControlSettings | アプリケーションの保護者による制御設定を指定します。 | MicrosoftGraphParentalControlSettings |
passwordCredentials | アプリケーションに関連付けられているパスワード資格情報のコレクション。 NULL 値は許可されません。 | MicrosoftGraphPasswordCredential[] |
publicClient | デスクトップやモバイル デバイスなど、インストールされているクライアントの設定を指定します。 | MicrosoftGraphPublicClientApplication |
publisherDomain | アプリケーションの確認された発行元のドメイン。 読み取り専用 | string (ReadOnly) |
requestSignatureVerification | このアプリケーションで、署名された認証要求を検証するために Microsoft Entra ID が必要かどうかを指定します。 | MicrosoftGraphRequestSignatureVerification |
requiredResourceAccess | アプリケーションからアクセスが必要なリソースを指定します。 このプロパティは、委任されたアクセス許可のセットと、それらの各リソースに必要なアプリケーション ロールも指定します。 この必要なリソースへのアクセスの構成によって、同意エクスペリエンスが促進されます。 構成できるリソース サービス (API) は 50 個以下です。 2021 年 10 月中旬以降、必要なアクセス許可の合計数が 400 を超えないようにする必要があります。 詳細については、「アプリごとの要求されたアクセス許可の制限」を参照してください。 NULL 値は許可されません | MicrosoftGraphRequiredResourceAccess[] |
samlMetadataUrl | サービスがフェデレーション用の SAML メタデータを公開する URL。 このプロパティは、シングルテナント アプリケーションでのみ有効です。 Null 許容。 | string |
serviceManagementReference | サービスまたは資産管理データベースからアプリケーションまたはサービスの連絡先情報を参照します。 Null 許容。 | string |
servicePrincipalLockConfiguration | テナントでアプリケーションをプロビジョニングした後、マルチテナント アプリケーションの機密性の高いプロパティを編集用にロックするかどうかを指定します。 Null 許容。 既定では null。 | MicrosoftGraphServicePrincipalLockConfiguration |
signInAudience | 現在のアプリケーションでサポートされている Microsoft アカウントを指定します。 使用できる値は、AzureADMyOrg (既定値)、AzureADMultipleOrgs、AzureADandPersonalMicrosoftAccount、PersonalMicrosoftAccount です。 表の詳細を参照してください。 このオブジェクトの値により、アプリが要求できるアクセス許可の数も制限されます。 詳細については、「アプリごとの要求されたアクセス許可の制限」を参照してください。 このプロパティの値は、他のアプリ オブジェクトのプロパティに影響します。 その結果、このプロパティを変更する場合は、最初に他のプロパティを変更する必要がある場合があります | string |
spa | 承認コードとアクセス トークンのサインアウト URL やリダイレクト URI など、シングルページ アプリケーションの設定を指定します。 | MicrosoftGraphSpaApplication |
tags | アプリケーションの分類と特定に使用できるカスタム文字列。 NULL 値は許可されません | string[] |
tokenEncryptionKeyId | keyCredentials コレクションの公開キーの keyId を指定します。 構成すると、Microsoft Entra ID は、このプロパティが指すキーを使用して、生成されるすべてのトークンを暗号化します。 暗号化されたトークンを受け取るアプリケーション コードでは、対応する秘密キーを使用してトークンを復号化する必要があります。その後で、現在サインインしているユーザー用にトークンを使用できるようになります。 | string 制約: 最小長 = 36 最大長 = 36 パターン = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$ |
type | リソースの種類 | 'Microsoft.Graph/applications' (ReadOnly) |
uniqueName | アプリケーションに割り当て、代替キーとして使用できる一意の識別子。 変更不可 | string (必須) |
verifiedPublisher | アプリケーションの検証済み発行元を指定します。 発行元の検証がアプリケーションのセキュリティ、信頼性、コンプライアンスをサポートする方法の詳細については、「発行元の検証」を参照してください。 | MicrosoftGraphVerifiedPublisher |
ウェブ | Web アプリケーションの設定を指定します。 | MicrosoftGraphWebApplication |
windows | Microsoft Windows を実行し、Microsoft Store または Xbox ゲーム ストアで公開されるアプリの設定を指定します。 | MicrosoftGraphWindowsApplication |
MicrosoftGraphPermissionScope
名前 | Description | Value |
---|---|---|
adminConsentDescription | 委任されたアクセス許可の説明。すべてのユーザーに代わってアクセス許可を付与する管理者が読み取ります。 このテキストは、テナント全体の管理者の同意エクスペリエンスに表示されます。 | string |
adminConsentDisplayName | すべてのユーザーに代わってアクセス許可を付与する管理者が読み取る権限のタイトル。 | string |
ID | リソース アプリケーションに対して定義された委任されたアクセス許可のコレクション内の一意の委任されたアクセス許可識別子。 | string 制約: 最小長 = 36 最大長 = 36 パターン = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$ |
IsEnabled | アクセス許可を作成または更新するときは、このプロパティを true (既定値) に設定する必要があります。 アクセス許可を削除するには、最初にこのプロパティを false に設定する必要があります。 その時点で、後続の呼び出しで、アクセス許可が削除される可能性があります。 | [bool] |
type | 指定できる値はユーザーと管理者です。管理者以外のユーザーが自分の代わりに同意するために、この委任されたアクセス許可を安全と見なすか、管理者の同意を常に必要とするかを指定します。 Microsoft Graph では各アクセス許可の既定の同意要件が定義されていますが、テナント管理者は組織内の動作をオーバーライドできます (この委任されたアクセス許可に対するユーザーの同意を許可、制限、または制限します)。 詳細については、「ユーザーがアプリケーションに同意する方法を構成する」を参照してください。 | string |
userConsentDescription | 委任されたアクセス許可の説明。ユーザーが自分の代わりにアクセス許可を付与することで読み取られます。 このテキストは、ユーザーが自分に代わってのみ同意している同意エクスペリエンスに表示されます。 | string |
userConsentDisplayName | アクセス許可のタイトル。ユーザーが自分の代わりにアクセス許可を付与することで読み取られます。 このテキストは、ユーザーが自分に代わってのみ同意している同意エクスペリエンスに表示されます。 | string |
値 | アクセス トークンの scp (スコープ) 要求に含める値を指定します。 長さは 120 文字以下にする必要があります。 使用できる文字は次のとおりです。 # $ % & ' ( ) * + , -. / : ;= ? @ [ ] ^ + _ { } ~、および 0 ~ 9、A ~ Z、a ~ z の範囲の文字。 スペース文字を含む他の文字は使用できません。 で始めないようにしてください。 | string |
MicrosoftGraphPreAuthorizedApplication
名前 | Description | Value |
---|---|---|
appId | クライアント アプリケーションの一意識別子。 | string |
permissionIds | クライアント アプリケーションに付与されるスコープの一意の識別子。 | string[] |
MicrosoftGraphApiApplication
名前 | Description | Value |
---|---|---|
acceptMappedClaims | true の場合、アプリケーションはカスタム署名キーを指定せずに要求マッピングを使用できます。 | [bool] |
knownClientApplications | クライアント アプリとカスタム Web API アプリの 2 つの部分を含むソリューションがある場合に、同意をバンドルするために使用されます。 クライアント アプリの appID をこの値に設定すると、ユーザーはクライアント アプリに 1 回だけ同意します。 Microsoft Entra ID は、クライアントへの同意は、Web API に暗黙的に同意することを意味し、両方の API のサービス プリンシパルを同時に自動的にプロビジョニングすることを認識しています。 クライアントと Web API アプリの両方が同じテナントに登録されている必要があります。 | string 制約: 最小長 = 36 最大長 = 36 パターン = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$ |
oauth2PermissionScopes | このアプリケーション登録によって表される Web API によって公開される委任されたアクセス許可の定義。 これらの委任されたアクセス許可は、クライアント アプリケーションによって要求される場合があり、同意時にユーザーまたは管理者によって付与される場合があります。 委任されたアクセス許可は、OAuth 2.0 スコープと呼ばれることもあります。 | MicrosoftGraphPermissionScope[] |
preAuthorizedApplications | このアプリケーションの API にアクセスするために、指定された委任されたアクセス許可で事前に認証されたクライアント アプリケーションを一覧表示します。 ユーザーは、(指定されたアクセス許可に対して) 事前認証されたアプリケーションに同意する必要はありません。 ただし、preAuthorizedApplications に記載されていないその他のアクセス許可 (増分同意などを通じて要求) には、ユーザーの同意が必要です。 | MicrosoftGraphPreAuthorizedApplication[] |
requestedAccessTokenVersion | このリソースで予期されるアクセス トークンのバージョンを指定します。 これにより、アクセス トークンを要求するために使用されたエンドポイントまたはクライアントとは関係なく、生成される JWT のバージョンと形式が変更されます。 使用されるエンドポイント (v1.0 または v2.0) はクライアントによって選択され、id_token のバージョンにのみ影響します。 リソースでは、サポートされているアクセス トークン形式を示すように requestedAccessTokenVersion を明示的に構成する必要があります。 requestedAccessTokenVersion に指定できる値は、1、2、または null です。 値が null の場合の既定値は 1 で、v1.0 のエンドポイントに対応します。 アプリケーションの signInAudience が AzureADandPersonalMicrosoftAccount または PersonalMicrosoftAccount として構成されている場合、このプロパティの値は 2 である必要があります。 | int |
MicrosoftGraphAppRole
名前 | Description | Value |
---|---|---|
allowedMemberTypes | このアプリ ロールをユーザーとグループに割り当て (['User']に設定)、他のアプリケーションに割り当てることができるかどうかを指定します (['Application']、またはその両方を (['User', 'Application'] に設定します)。 他のアプリケーションのサービス プリンシパルへの割り当てをサポートするアプリ ロールは、アプリケーションのアクセス許可とも呼ばれます。 "Application" 値は、アプリケーション エンティティで定義されているアプリ ロールでのみサポートされます。 | string[] |
description | アプリ ロールの説明。 これは、アプリ ロールが割り当てられているときに表示され、アプリ ロールがアプリケーションのアクセス許可として機能する場合は、同意エクスペリエンス中に表示されます。 | string |
displayName | アプリ ロールの割り当てと同意エクスペリエンスに表示されるアクセス許可の表示名。 | string |
ID | appRoles コレクション内の一意のロール識別子。 新しいアプリ ロールを作成するときは、新しい GUID 識別子を指定する必要があります。 | string 制約: 最小長 = 36 最大長 = 36 パターン = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$ |
IsEnabled | アプリ ロールを作成または更新するときは、これを true (既定値) に設定する必要があります。 ロールを削除するには、最初に false に設定する必要があります。 その時点で、後続の呼び出しでは、このロールが削除される可能性があります。 | [bool] |
配信元 | アプリ ロールがアプリケーション オブジェクトまたは servicePrincipal エンティティで定義されているかどうかを指定します。 POST または PATCH 要求には含めてはなりません。 読み取り専用です。 | string (ReadOnly) |
値 | 割り当てられたユーザーまたはサービス プリンシパルを認証する ID トークンとアクセス トークンのロール要求に含める値を指定します。 長さは 120 文字以下にする必要があります。 使用できる文字は次のとおりです。 # $ % & ' ( ) * + , -. / : ;= ? @ [ ] ^ + _ { } ~、および 0 ~ 9、A ~ Z、a ~ z の範囲の文字。 スペース文字を含む他の文字は使用できません。 で始めないようにしてください。 | string |
MicrosoftGraphAuthenticationBehaviors
名前 | Description | Value |
---|---|---|
blockAzureADGraphAccess | [bool] | |
removeUnverifiedEmailClaim | 電子メール アドレスのドメインを検証できない場合に、アプリケーションに送信されたトークンから電子メール要求を削除します。 | [bool] |
requireClientServicePrincipal | マルチテナント アプリケーションにアクセス トークンが付与される前に、承認チェックの一部としてリソース テナントにサービス プリンシパルが必要です。 このプロパティは、サービス プリンシパルのないクライアントからのアクセスに依存し、Microsoft によってこの動作が false に設定されているマルチテナント リソース アプリケーションでのみ変更できます。 テナント管理者は、Azure ヘルス サービス イベントと Microsoft 365 メッセージ センターを通じて送信されるセキュリティ アドバイザリに対応する必要があります。 | [bool] |
MicrosoftGraphCertification
名前 | Description | Value |
---|---|---|
certificationDetailsUrl | アプリケーションの認定の詳細を示す URL。 | string |
certificationExpirationDateTime | アプリケーションの現在の証明書の有効期限が切れたときのタイムスタンプ。 | string |
isCertifiedByMicrosoft | アプリケーションが Microsoft によって認定されているかどうかを示します。 | [bool] |
isPublisherAttested | アプリケーションがアプリケーション開発者または発行元によって自己証明されたかどうかを示します。 | [bool] |
lastCertificationDateTime | アプリケーションの認定が最後に追加または更新されたときのタイムスタンプ。 | string |
MicrosoftGraphInformationalUrl
名前 | Description | Value |
---|---|---|
logoUrl | アプリケーションのロゴへの CDN URL(読み取り専用)。 | string (ReadOnly) |
marketingUrl | アプリケーションのマーケティング ページにリンクします。 たとえば、https://www.contoso.com/app/marketing のように指定します。 | string |
privacyStatementUrl | アプリケーションのプライバシーに関する声明へのリンク。 たとえば、https://www.contoso.com/app/privacy のように指定します。 | string |
supportUrl | アプリケーションのサポート ページにリンクします。 たとえば、https://www.contoso.com/app/support のように指定します。 | string |
termsOfServiceUrl | アプリケーションのサービス条件ステートメントにリンクします。 たとえば、https://www.contoso.com/app/termsofservice のように指定します。 | string |
MicrosoftGraphKeyCredential
名前 | Description | Value |
---|---|---|
customKeyIdentifier | 資格情報を識別するために使用できる 40 文字のバイナリ型。 省略可能。 ペイロードで指定しない場合、既定では証明書の拇印が使用されます。 | string |
displayName | キーのフレンドリ名。 省略可能。 | string |
endDateTime | 資格情報の有効期限が切れる日時。 DateTimeOffset 型は日時の情報を表し、ISO 8601 形式を使用して、常に UTC 時間を示します。 たとえば、2014 年 1 月 1 日の午前 0 時 (UTC) は 2014-01-01T00:00:00Z です。 | string |
キー | キー資格情報の値。 Base64 でエンコードされた値にする必要があります。 .cer証明書から、Convert.ToBase64String() メソッドを使用してキーを読み取ることができます。 詳細については、「証明書キーを取得する」を参照してください。 | string |
keyId | キーの一意識別子。 | string 制約: 最小長 = 36 最大長 = 36 パターン = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$ |
startDateTime | 資格情報が有効になる日時。Timestamp 型は、ISO 8601 形式を使用して日付と時刻の情報を表し、常に UTC 時刻です。 たとえば、2014 年 1 月 1 日の午前 0 時 (UTC) は 2014-01-01T00:00:00Z です。 | string |
type | キー資格情報の種類。たとえば、Symmetric、AsymmetricX509Cert、X509CertAndPassword などです。 | string |
使用量 | キーを使用できる目的を説明する文字列。たとえば、None、Verify、PairwiseIdentifier、Delegation、Decrypt、Encrypt、HashedIdentifier、SelfSignedTls、Sign などです。 使用法が Sign の場合、型は X509CertAndPassword、署名用の passwordCredentials を定義する必要があります。 | string |
MicrosoftGraphOptionalClaim
名前 | Description | Value |
---|---|---|
additionalProperties | 要求の追加のプロパティ。 このコレクションにプロパティが存在する場合、name プロパティに指定された省略可能な要求の動作が変更されます。 | string[] |
Essential | 値が true の場合、エンド ユーザーから要求された特定のタスクの承認エクスペリエンスを円滑にするために、クライアントに指定された要求が必要です。 既定値は false です。 | [bool] |
name | 省略可能な要求の名前。 | string |
source | 要求のソース (ディレクトリ オブジェクト)。 定義済みの要求と、拡張プロパティのユーザー定義の要求があります。 ソース値が null の場合、この要求は定義済みの省略可能な要求です。 ソース値が user の場合、name プロパティの値はユーザー オブジェクトの拡張プロパティです。 | string |
MicrosoftGraphOptionalClaims
名前 | Description | Value |
---|---|---|
accessToken | JWT アクセス トークンで返される省略可能な要求。 | MicrosoftGraphOptionalClaim[] |
idToken | JWT ID トークンで返される省略可能な要求。 | MicrosoftGraphOptionalClaim[] |
saml2Token | JWT SAML トークンで返される省略可能な要求。 | MicrosoftGraphOptionalClaim[] |
MicrosoftGraphParentalControlSettings
名前 | Description | Value |
---|---|---|
countriesBlockedForMinors | 2 文字の ISO 国コードを指定します。 この一覧で指定された国からの未成年者の場合、アプリケーションへのアクセスはブロックされます。 | string[] |
legalAgeGroupRule | アプリのユーザーに適用される法的年齢グループルールを指定します。 ValueDescriptionAllowDefault のいずれかの値に設定できます。 法的最小値を適用します。 これは、欧州連合および韓国の未成年者に対して保護者の同意が必要であることを意味します。COPPA 規則に準拠するために生年月日を指定するには、ユーザーに対してConsentForPrivacyServicesEnforces が必要です。 国のマイナー ルールに関係なく、18 未満の年齢の保護者の同意が必要です。国のマイナー ルールに関係なく、14 未満の年齢の保護者の同意が必要です。BlockMinorsBlocks 未成年者がアプリを使用できないようにします。 | string |
MicrosoftGraphPasswordCredential
名前 | Description | Value |
---|---|---|
displayName | パスワードのフレンドリ名。 省略可能。 | string |
endDateTime | パスワードの有効期限が切れる日時は、ISO 8601 形式で表され、常に UTC 時刻で表されます。 たとえば、2014 年 1 月 1 日の午前 0 時 (UTC) は 2014-01-01T00:00:00Z です。 省略可能。 | string |
ヒント | パスワードの最初の 3 文字を格納します。 読み取り専用です。 | string (ReadOnly) |
keyId | パスワードの一意識別子。 | string 制約: 最小長 = 36 最大長 = 36 パターン = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$ |
secretText | 読み取り専用。長さが 16 ~ 64 文字の Microsoft Entra ID によって生成された強力なパスワードが含まれます。 生成されたパスワード値は、addPassword への最初の POST 要求中にのみ返されます。 今後、このパスワードを取得する方法はありません。 | string (ReadOnly) |
startDateTime | パスワードが有効になる日時。 このタイムスタンプの種類は、日時の情報を ISO 8601 形式で表し、常に UTC 時間です。 たとえば、2014 年 1 月 1 日の午前 0 時 (UTC) は 2014-01-01T00:00:00Z です。 省略可能。 | string |
MicrosoftGraphPublicClientApplication
名前 | Description | Value |
---|---|---|
redirectUris | ユーザー トークンがサインイン用に送信される URL、または OAuth 2.0 承認コードとアクセス トークンが送信されるリダイレクト URI を指定します。 | string[] |
MicrosoftGraphRequestSignatureVerification
名前 | Description | Value |
---|---|---|
allowedWeakAlgorithms | このアプリケーションが弱いアルゴリズムを受け入れるかどうかを指定します。 指定できる値は rsaSha1、unknownFutureValue です。 | string |
isSignedRequestRequired | このアプリケーションの署名された認証要求を必要とするかどうかを指定します。 | [bool] |
MicrosoftGraphResourceAccess
名前 | Description | Value |
---|---|---|
ID | リソース アプリケーションによって公開されるアプリ ロールまたは委任されたアクセス許可の一意識別子。 委任されたアクセス許可の場合、これはリソース アプリケーションのサービス プリンシパルの oauth2PermissionScopes コレクション内の委任されたアクセス許可の id プロパティと一致する必要があります。 アプリ ロール (アプリケーションのアクセス許可) の場合、これはリソース アプリケーションのサービス プリンシパルの appRoles コレクション内のアプリ ロールの id プロパティと一致する必要があります。 | string 制約: 最小長 = 36 最大長 = 36 パターン = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$ |
type | id プロパティが委任されたアクセス許可またはアプリ ロール (アプリケーションのアクセス許可) を参照するかどうかを指定します。 使用可能な値は、スコープ (委任されたアクセス許可の場合) またはロール (アプリ ロールの場合) です。 | string |
MicrosoftGraphRequiredResourceAccess
名前 | Description | Value |
---|---|---|
resourceAccess | 指定されたリソースからアプリケーションが必要とする OAuth2.0 アクセス許可スコープとアプリ ロールの一覧。 | MicrosoftGraphResourceAccess[] |
resourceAppId | アプリケーションがアクセスする必要があるリソースの一意識別子。 これは、ターゲット リソース アプリケーションで宣言されている appId と同じである必要があります。 | string |
MicrosoftGraphServicePrincipalLockConfiguration
名前 | Description | Value |
---|---|---|
allProperties | すべての機密性の高いプロパティのロックを有効にします。 機密性の高いプロパティは、keyCredentials、passwordCredentials、tokenEncryptionKeyId です。 | [bool] |
credentialsWithUsageSign | 資格情報の使用の種類が Sign である変更のために、keyCredentials プロパティと passwordCredentials プロパティをロックします。 | [bool] |
credentialsWithUsageVerify | 資格情報の使用の種類が Verify である変更のために、keyCredentials プロパティと passwordCredentials プロパティをロックします。 これにより、OAuth サービス プリンシパルがロックされます。 | [bool] |
IsEnabled | サービス プリンシパルのロック構成を有効または無効にします。 機密性の高いプロパティを更新できるようにするには、このプロパティを false に更新して、サービス プリンシパルのロックを無効にします。 | [bool] |
tokenEncryptionKeyId | サービス プリンシパルの変更のために tokenEncryptionKeyId プロパティをロックします。 | [bool] |
MicrosoftGraphSpaApplication
名前 | Description | Value |
---|---|---|
redirectUris | ユーザー トークンがサインイン用に送信される URL、または OAuth 2.0 承認コードとアクセス トークンが送信されるリダイレクト URI を指定します。 | string[] |
MicrosoftGraphVerifiedPublisher
名前 | Description | Value |
---|---|---|
addedDateTime | 検証済みの発行元が最初に追加されたとき、または最後に更新されたときのタイムスタンプ。 | string |
displayName | アプリの発行元の Microsoft Partner Network (MPN) アカウントの検証済み発行元名。 | string |
verifiedPublisherId | アプリの発行元のパートナー センター アカウントの検証済み発行元の ID。 | string |
MicrosoftGraphImplicitGrantSettings
名前 | Description | Value |
---|---|---|
enableAccessTokenIssuance | この Web アプリケーションが OAuth 2.0 暗黙的フローを使用してアクセス トークンを要求できるかどうかを指定します。 | [bool] |
enableIdTokenIssuance | この Web アプリケーションが OAuth 2.0 の暗黙的フローを使用して ID トークンを要求できるかどうかを指定します。 | [bool] |
MicrosoftGraphRedirectUriSettings
名前 | Description | Value |
---|---|---|
インデックス | SAML SSO フローの redirectURIs コレクション内の特定の URI を識別します。 既定値は null です。 インデックスは、アプリケーションのすべての redirectUris で一意です。 | int |
uri | トークンの送信先の URI を指定します。 | string |
MicrosoftGraphWebApplication
名前 | Description | Value |
---|---|---|
homePageUrl | アプリケーションのホーム ページまたはランディング ページ。 | string |
implicitGrantSettings | この Web アプリケーションが OAuth 2.0 暗黙的フローを使用してトークンを要求できるかどうかを指定します。 | MicrosoftGraphImplicitGrantSettings |
logoutUrl | フロント チャネル、バックチャネル、または SAML ログアウト プロトコルを使用してユーザーをログアウトするために Microsoft の承認サービスによって使用される URL を指定します。 | string |
oauth2AllowImplicitFlow | [bool] | |
redirectUris | ユーザー トークンがサインイン用に送信される URL、または OAuth 2.0 承認コードとアクセス トークンが送信されるリダイレクト URI を指定します。 | string[] |
redirectUriSettings | サインインのためにユーザー トークンが送信される URL のインデックスを指定します。 これは、SAML を使用するアプリケーションでのみ有効です。 | MicrosoftGraphRedirectUriSettings[] |
MicrosoftGraphWindowsApplication
名前 | Description | Value |
---|---|---|
packageSid | Microsoft がアプリケーションを割り当てたパッケージ セキュリティ識別子。 省略可能。 読み取り専用です。 | string (ReadOnly) |
redirectUris | ユーザー トークンがサインイン用に送信される URL、または OAuth 2.0 承認コードとアクセス トークンが送信されるリダイレクト URI を指定します。 PersonalMicrosoftAccount signInAudience をサポートするアプリケーションでのみ使用できます。 | string[] |