servicePrincipal リソースの種類
名前空間: microsoft.graph
ディレクトリ内のアプリケーションのインスタンスを表します。 directoryObject から継承します。
このリソースは、デルタ関数を提供することによって、増分の追加、削除、および更新を追跡するためのデルタ クエリの使用をサポートしています。 このリソースは、他のプロパティを渡すことができるオープン型です。
メソッド
メソッド | 戻り値の型 | 説明 |
---|---|---|
List | servicePrincipal コレクション | servicePrincipal オブジェクトの一覧を取得します。 |
Create | servicePrincipal | 新しい servicePrincipal オブジェクトを作成します。 |
Get | servicePrincipal | servicePrincipal オブジェクトのプロパティとリレーションシップを読み取ります。 |
更新する | servicePrincipal | servicePrincipal オブジェクトを更新します。 |
Upsert | servicePrincipal | 新しい servicePrincipal が存在しない場合は作成するか、既存の servicePrincipal のプロパティを更新します。 |
Delete | なし | servicePrincipal オブジェクトを削除します。 |
Deltaを取得する | servicePrincipal コレクション | サービス プリンシパルに対する増分の変更を取得します。 |
作成されたオブジェクトを一覧表示する | directoryObject コレクション | createdObject オブジェクト コレクションを取得します。 |
所有されているオブジェクトを一覧表示する | directoryObject コレクション | ownedObject オブジェクト コレクションを取得します。 |
削除済みアイテム | ||
List | directoryObject コレクション | servicePrincipal オブジェクトの一覧を取得します。 |
Get | directoryObject | servicePrincipal オブジェクトのプロパティとリレーションシップを取得します。 |
復元 | directoryObject | 最近削除した servicePrincipal オブジェクトを復元します。 |
完全に削除 | なし | servicePrincipal オブジェクトを完全に削除します。 |
App role assignments | ||
List appRoleAssignments | appRoleAssignment コレクション | このサービス プリンシパルが割り当てられているアプリ ロールを取得します。 |
Add appRoleAssignment | appRoleAssignment | このサービスプリンシパルにアプリの役割を割り当てます。 |
appRoleAssignment を削除する | なし | このサービスプリンシパルからアプリの役割の割り当てを削除します。 |
appRoleAssignedTo をリストする | appRoleAssignment コレクション | このサービスプリンシパルのアプリ役割が割り当てられているユーザー、グループ、サービスプリンシパルを取得します。 |
appRoleAssignedTo を追加する | appRoleAssignment | このサービスプリンシパルのアプリ役割をユーザー、グループ、またはサービスプリンシパルに割り当てます。 |
appRoleAssignedTo を削除する | なし | ユーザー、グループ、またはサービスプリンシパルからこのサービスプリンシパルへのアプリ役割の割り当てを削除します。 |
証明書とシークレット | ||
パスワードを追加する | passwordCredential | 強力なパスワードまたはシークレットを servicePrincipal に追加します。 |
パスワードを削除する | passwordCredential | servicePrincipal からパスワードまたはシークレットを削除します。 |
キーの追加 | keyCredential | 鍵資格情報を servicePrincipal に追加します。 |
キーの削除 | なし | servicePrincipal からキー資格情報を削除します。 |
トークン署名証明書を追加する | selfSignedCertificate | 自己署名証明書をサービス プリンシパルに追加します。 主に 、Microsoft Entra ギャラリーから SAML ベースの SSO アプリケーションを構成するために使用されます。 |
代理アクセス許可の分類 | ||
List | delegatedPermissionClassification コレクション | このサービスプリンシパルによって公開される代理アクセス許可のアクセス許可の分類を取得します。 |
追加する | delegatedPermissionClassification | このサービスプリンシパルによって公開された、代理アクセス許可のアクセス許可の分類を追加します。 |
Remove | なし | このサービスプリンシパルによって公開された代理アクセス許可のアクセス許可の分類を削除します。 |
委任された (OAuth2) アクセス許可の付与 | ||
List | oAuth2PermissionGrant コレクション | サインインしているユーザーに代わってこのサービスプリンシパルが API にアクセスすることを承認する、委任されたアクセス許可を取得します。 |
メンバーシップ | ||
memberOf を一覧表示する | directoryObject コレクション | memberOf ナビゲーション プロパティからこのサービス プリンシパルが直接のメンバーであるグループを取得します。 |
推移的な所属を一覧表示する | directoryObject コレクション | このサービス プリンシパルがメンバーになっているグループを一覧表示します。 この操作は推移的で、このサービス プリンシパルが入れ子のメンバーになっているグループが含まれます。 |
メンバー グループをチェックする | String collection | 指定したグループ一覧内のメンバーシップを確認します。 |
メンバー オブジェクトを確認する | String collection | 指定したグループ、ディレクトリ役割、または管理ユニット オブジェクト一覧内のメンバーシップを確認します。 |
メンバー グループを取得する | String collection | このサービス プリンシパルがメンバーになっているグループ一覧を取得します。 |
メンバー オブジェクトを取得する | String collection | このサービス プリンシパルがメンバーになっているグループ、管理単位、およびディレクトリ ロールの一覧を取得します。 |
所有者 | ||
List | directoryObject コレクション | サービス プリンシパルの所有者を取得します。 |
追加する | directoryObject | サービス プリンシパルに所有者を割り当てます。 サービス プリンシパルの所有者には、ユーザーまたはその他のサービス プリンシパルを指定できます。 |
Remove | なし | サービス プリンシパルから所有者を削除します。 推奨されるベスト プラクティスとして、サービス プリンシパルには少なくとも 2 人の所有者が必要です。 |
プロパティ
重要
$filter
および $search
クエリ パラメーターの具体的な使用方法は、ConsistencyLevel ヘッダーの設定を eventual
と $count
に使用する場合にのみサポートされます。 詳細については、「ディレクトリ オブジェクトの詳細クエリ機能」を参照してください。
プロパティ | 型 | 説明 |
---|---|---|
accountEnabled | Boolean |
true サービス プリンシパルのアカウントが有効な場合。それ以外の場合は false 。
false に設定されている場合、ユーザーは割り当てられている場合でも、このアプリにサインインできません。
$filter (eq 、ne 、not 、in ) をサポートします。 |
addIns | addIn コレクション | 特定のコンテキストで利用者サービスがアプリを呼び出すために使用できるカスタムの動作を定義します。 たとえば、ファイル ストリームのレダリングが可能なアプリケーションは、そのアプリケーションの "FileHandler" 機能のために addIns プロパティを設定することがあります。 これにより、Microsoft 365 などのサービスは、ユーザーが作業しているドキュメントのコンテキストでアプリケーションを呼び出すことができます。 |
alternativeNames | String コレクション | サブスクリプション別にサービス プリンシパルを取得するために使用され、マネージド ID のリソース グループと完全なリソース ID を識別します。
$filter (eq 、not 、ge 、le 、startsWith ) をサポートします。 |
appDescription | String | 関連付けられているアプリケーションによって公開される説明。 |
appDisplayName | String | 関連付けられているアプリケーションによって公開される表示名。 |
appId | String | 関連付けられたアプリケーションの一意の識別子 (その appId プロパティ)。 代替キー。
$filter (eq 、ne 、not 、in 、startsWith ) をサポートします。 |
applicationTemplateId | String |
applicationTemplate の一意識別子。
$filter (eq 、not 、ne ) をサポートします。 読み取り専用です。
null サービス プリンシパルがアプリケーション テンプレートから作成されていない場合。 |
appOwnerOrganizationId | Guid | アプリケーションが登録されているテナント ID を格納します。 これは、アプリケーションによってサポートされるサービスプリンシパルにのみ適用されます。
$filter (eq 、ne 、NOT 、ge 、le ) をサポートします。 |
appRoleAssignmentRequired | ブール値 | ユーザーがサインインしたり、アプリがトークンを取得したりする前に、ユーザーまたは他のサービスプリンシパルに、このサービスプリンシパルへのアプリの役割の割り当てを付与する必要があるかどうかを指定します。 既定値は false です。 null 許容ではありません。 $filter (eq 、ne 、NOT ) をサポートします。 |
appRoles | appRole コレクション | このサービス プリンシパルにリンクされているアプリケーションによって公開されるロール。 詳細については、アプリケーション エンティティの appRoles プロパティ定義に関するページを参照してください。 null 許容ではありません。 |
customSecurityAttributes | customSecurityAttributeValue | ディレクトリ オブジェクトに割り当てられたカスタム セキュリティ属性の値を保持するオープン複合型。 Null 許容型です。 でのみ返されます。 $select
$filter (eq 、ne 、not 、startsWith ) をサポートします。 フィルター値では大文字と小文字が区別されます。 |
deletedDateTime | DateTimeOffset | サービスプリンシパルが削除された日時。 読み取り専用です。 |
説明 | String | サービス プリンシパルの内部エンド ユーザー向けの説明を提供するフリー テキスト フィールド。
MyApps などのエンド ユーザー ポータルには、このフィールドにアプリケーションの説明が表示されます。 許可される最大サイズは 1,024 文字です。
$filter (eq 、ne 、not 、ge 、le 、startsWith 、$search ) をサポートします。 |
disabledByMicrosoftStatus | String | Microsoft で登録済みアプリケーションを無効にしたかどうかを指定します。 使用可能な値は、 null (既定値)、 NotDisabled 、および DisabledDueToViolationOfServicesAgreement です (疑わしい、虐待的、または悪意のあるアクティビティ、または Microsoft サービス契約違反が含まれる理由)。 $filter (eq 、ne 、not ) をサポートします。 |
displayName | String | サービス プリンシパルの表示名。
$filter (eq 、ne 、not 、ge 、le 、in 、startsWith 、および eq の null 値)、$search 、および $orderby をサポートします。 |
HomePage | String | アプリケーションのホームページまたはランディングページ。 |
id | String | サービス プリンシパルの一意識別子。
directoryObject から継承されます。 キー。 null 許容ではありません。 読み取り専用です。
$filter (eq 、ne 、not 、in ) をサポートします。 |
info | informationalUrl | アプリのマーケティング、サポート、利用規約、プライバシーに関する声明のURLなど、取得したアプリケーションの基本的なプロファイル情報。 サービス利用規約とプライバシーに関する声明は、ユーザーの同意エクスペリエンスからユーザーに提示されます。 詳細については、「方法: 登録済みの Microsoft Entra アプリのサービス条件とプライバシーに関する声明を追加する」を参照してください。 $filter (eq 、ne 、not 、ge 、le 、および< eq の null 値)をサポートします。 |
keyCredentials | keyCredential コレクション | サービス プリンシパルに関連付けられているキー資格情報のコレクションです。null 許容型ではありません。 null 許容ではありません。
$filter (eq 、not 、ge 、le ) をサポートします。 |
loginUrl | String | サービス プロバイダーがユーザーを Microsoft Entra ID にリダイレクトして認証する URL を指定します。 Microsoft Entra ID では、URL を使用して、Microsoft 365 または Microsoft Entra My Apps からアプリケーションを起動します。 空白の場合、Microsoft Entra ID は 、SAML ベースのシングル サインオンで構成されたアプリケーションに対して IdP によって開始されるサインオンを実行します。 ユーザーは、Microsoft 365、Microsoft Entra My Apps、または Microsoft Entra SSO URL からアプリケーションを起動します。 |
logoutUrl | String | OpenID Connect フロント チャネル、 バック チャネル、または SAML サインアウト プロトコルを使用してユーザーをサインアウトするために Microsoft の承認サービスが使用する URL を指定します。 |
notes | String | 通常は運用目的で使用される、サービス プリンシパルに関する情報を取得するためのフリー テキスト フィールド。 最大許容サイズは 1,024 文字です。 |
notificationEmailAddresses | String コレクション | アクティブな証明書が有効期限の近くにあるときに Microsoft Entra ID が通知を送信する電子メール アドレスの一覧を指定します。 これは、Microsoft Entra Gallery アプリケーション用に発行された SAML トークンの署名に使用される証明書に対してのみです。 |
oauth2PermissionScopes | permissionScope コレクション | アプリケーションによって公開された委任された権限。 詳細については、アプリケーション エンティティの api プロパティの oauth2PermissionScopes プロパティを参照してください。 null 許容ではありません。 |
passwordCredentials | passwordCredential コレクション | アプリケーションに関連付けられているパスワード資格情報のコレクションです。 null 許容ではありません。 |
preferredSingleSignOnMode | string | このアプリケーションに構成されているシングルサインオンモードを指定します。 Microsoft Entra ID では、優先シングル サインオン モードを使用して、Microsoft 365 またはマイ アプリ ポータルからアプリケーションを起動します。 サポートされている値は password 、saml 、notSupported 、および oidc です。 |
preferredTokenSigningKeyThumbprint | String | このプロパティは、SAML アプリケーション ( preferredSingleSignOnMode が saml に設定されているアプリ) で使用して、SAML 応答の署名に使用される証明書を制御できます。 SAML ではないアプリケーションの場合は、このプロパティを書き込んだり、このプロパティに依存したりしないでください。 |
replyUrls | String コレクション | 関連付けられたアプリケーションにサインインするためにユーザー トークンが送信される URL、または関連付けられたアプリケーションに対して OAuth 2.0 認証コードとアクセス トークンが送信されるリダイレクト URI。 null 許容ではありません。 |
resourceSpecificApplicationPermissions | resourceSpecificPermission コレクション | このアプリケーションによって公開されるリソース固有のアプリケーションのアクセス許可。 現在、リソース固有のアクセス許可は、Microsoft Graph を使用して特定のチャットやチームにアクセスする Teams アプリでのみサポートされています。 読み取り専用です。 |
samlSingleSignOnSettings | samlSingleSignOnSettings | saml シングルサインオンに関連する設定のコレクション。 |
servicePrincipalNames | String コレクション | 関連するアプリケーションからコピーされた identifiersUris のリストが含まれています。 ハイブリッドアプリケーションに追加の値を追加できます。 これらの値を使用して、Microsoft Entra ID 内でこのアプリによって公開されるアクセス許可を識別できます。 例えば、
多値プロパティのフィルター式には、any 演算子が必要です。 null 許容ではありません。 $filter (eq 、not 、ge 、le 、startsWith ) をサポートします。 |
servicePrincipalType | String | サービス プリンシパルがアプリケーションや管理された ID またはレガシ アプリケーションを表すかどうかを識別します。 これは、Microsoft Entra ID によって内部的に設定されます。
servicePrincipalType プロパティは、3 つの値に設定できます。
|
signInAudience | String | 現在のアプリケーションでサポートされている Microsoft アカウントを指定します。 読み取り専用です。 サポートされている値は次のとおりです。
|
tags | String コレクション | サービスプリンシパルの分類と識別に使用できるカスタム文字列。 null 許容ではありません。 値は、ここで、関連付けられている アプリケーション エンティティの tags プロパティに設定された文字列の和集合です。$filter (eq 、not 、ge 、le 、startsWith ) をサポートします。 |
tokenEncryptionKeyId | String | keyCredentials コレクションにある公開キーの keyId を指定します。 構成すると、Microsoft Entra ID は、このプロパティで指定されたキーを使用して暗号化されたこのアプリケーションのトークンを発行します。 暗号化されたトークンを受け取るアプリケーション コードでは、一致する秘密キーを使用してトークンを複合化してから、サインインしているユーザーのトークンとして使用する必要があります。 |
verifiedPublisher | verifiedPublisher | このサービス プリンシパルにリンクされているアプリケーションの検証済み発行元を指定します。 |
リレーションシップ
重要
$filter
クエリ パラメーターの具体的な使用方法は、ConsistencyLevel ヘッダーを eventual
および $count
に設定した場合にのみサポートされます。 詳細については、「ディレクトリ オブジェクトの詳細クエリ機能」を参照してください。
リレーションシップ | 型 | 説明 |
---|---|---|
appManagementPolicies | appManagementPolicy コレクション | このアプリケーションに適用される appManagementPolicy。 |
appRoleAssignedTo | appRoleAssignment | ユーザー、グループ、その他のサービス プリンシパルに付与される、このアプリまたはサービスのアプリの役割の割り当て。
$expand をサポートします。 |
appRoleAssignments | appRoleAssignment コレクション | このサービス プリンシパルに付与される、別のアプリまたはサービスのアプリの役割の割り当て。
$expand をサポートします。 |
claimsMappingPolicies | claimsMappingPolicy コレクション | このサービス プリンシパルに割り当てられている claimsMappingPolicies。
$expand をサポートします。 |
createdObjects | directoryObject コレクション | このサービス プリンシパルで作成したディレクトリ オブジェクト。 読み取り専用です。 Null 許容型。 |
federatedIdentityCredentials | federatedIdentityCredential のコレクション | 特定の種類のサービス プリンシパルのフェデレーション ID - マネージド ID。
$expand と$filter (/$count eq 0 、/$count ne 0 ) をサポートします。 |
homeRealmDiscoveryPolicies | homeRealmDiscoveryPolicy コレクション | このサービス プリンシパルに割り当てられている homeRealmDiscoveryPolicies。
$expand をサポートします。 |
memberOf | directoryObject コレクション | このサービス プリンシパルがメンバーになっている役割。 HTTP メソッド: GET 読み取り専用。 Null 許容型です。
$expand をサポートします。 |
oauth2PermissionGrants | oAuth2PermissionGrant コレクション | 委任されたアクセス許可は、サインインしたユーザーに代わってこのサービスプリンシパルが API にアクセスすることを許可します。 読み取り専用です。 Null 許容型。 |
ownedObjects | directoryObject コレクション | このサービス プリンシパルが所有するディレクトリ オブジェクト。 読み取り専用です。 Null 許容型。
$expand 、$expand で入れ子になっている $select 、および $filter (/$count eq 0 、/$count ne 0 、/$count eq 1 、/$count ne 1 ) をサポートします。 |
owners | directoryObject コレクション | この servicePrincipal の所有者であるディレクトリオブジェクト。 所有者は、このオブジェクトの変更を許可されている管理者以外のユーザーまたは servicePrincipals のセットです。 読み取り専用です。 Null 許容型。
$expand で入れ子になった$expand 、$filter (/$count eq 0 、/$count ne 0 、/$count eq 1 、/$count ne 1 )、$select をサポートします。 |
remoteDesktopSecurityConfiguration | remoteDesktopSecurityConfiguration | このサービス プリンシパルに適用される remoteDesktopSecurityConfiguration オブジェクト。
isRemoteDesktopProtocolEnabled プロパティの$filter (eq ) をサポートします。 |
同期 | 同期 | Microsoft Graph API を使用した Microsoft Entra ID 同期の機能を表します。 |
tokenIssuancePolicies | tokenIssuancePolicy コレクション | このサービスプリンシパルに割り当てられ たtokenIssuancePolicies。 |
tokenLifetimePolicy | tokenLifetimePolicy コレクション | このサービス プリンシパルに割り当てられている tokenLifetimePolicies。 |
JSON 表記
次の JSON 表現は、リソースの種類を示しています。
{
"accountEnabled": true,
"addIns": [{"@odata.type": "microsoft.graph.addIn"}],
"alternativeNames": ["String"] ,
"appDisplayName": "String",
"appId": "String",
"appOwnerOrganizationId": "Guid",
"appRoleAssignmentRequired": true,
"appRoles": [{"@odata.type": "microsoft.graph.appRole"}],
"customSecurityAttributes": {
"@odata.type": "microsoft.graph.customSecurityAttributeValue"
},
"disabledByMicrosoftStatus": "String",
"displayName": "String",
"homepage": "String",
"id": "String (identifier)",
"info": {"@odata.type": "microsoft.graph.informationalUrl"},
"keyCredentials": [{"@odata.type": "microsoft.graph.keyCredential"}],
"logoutUrl": "String",
"notes": "String",
"oauth2PermissionScopes": [{"@odata.type": "microsoft.graph.permissionScope"}],
"passwordCredentials": [{"@odata.type": "microsoft.graph.passwordCredential"}],
"preferredTokenSigningKeyThumbprint": "String",
"replyUrls": ["String"],
"resourceSpecificApplicationPermissions": [{"@odata.type": "microsoft.graph.resourceSpecificPermission"}],
"servicePrincipalNames": ["String"],
"servicePrincipalType": "String",
"tags": ["String"],
"tokenEncryptionKeyId": "String",
"verifiedPublisher": {"@odata.type": "microsoft.graph.verifiedPublisher"}
}
フィードバック
https://aka.ms/ContentUserFeedback」を参照してください。
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「フィードバックの送信と表示