Тип ресурса claimsMappingPolicy
Пространство имен: microsoft.graph
Представляет политики сопоставления утверждений для протоколов WS-Fed, SAML, OAuth 2.0 и OpenID Connect для маркеров, выданных конкретному приложению. Политики сопоставления утверждений можно использовать для:
- Выбор утверждений, включенных в маркеры
- Создание еще не существующих типов утверждений
- Выбор или изменение источника данных, выдаваемых в определенных утверждениях
Количество утверждений и преобразований, которые можно добавить в политику сопоставления утверждений, ограничено для уменьшения размера маркера. Все записи схемы утверждений или преобразования, возникающие после достижения ограничения, игнорируются и включаются в выданный маркер. Дополнительные сведения об ограничениях см. в разделе Свойства определения политики сопоставления утверждений.
Дополнительные сведения о сценарии и конфигурации см . в разделах Тип политики сопоставления утверждений и Практическое руководство. Настройка утверждений, создаваемых в маркерах для определенного приложения в клиенте.
Кроме того, ознакомьтесь с разделом Настройка утверждений с помощью политики , чтобы узнать разницу между этой политикой и настраиваемой политикой утверждений.
Наследует от stsPolicy.
Методы
Метод | Возвращаемый тип | Описание |
---|---|---|
Список | claimsMappingPolicy | Чтение свойств и связей объектов claimsMappingPolicies. |
Создание | claimsMappingPolicy | Создайте объект claimsMappingPolicy. |
Получение | claimsMappingPolicy | Чтение свойств и связей объекта claimsMappingPolicy. |
Обновление | Нет | Обновление объекта claimsMappingPolicy. |
удаление; | Нет | Удаление объекта claimsMappingPolicy. |
Список применяется к | Коллекция directoryObject | Получите список объектов каталога, к которым применена эта политика. |
Назначение субъекту-службе | Нет | Назначьте объект claimsMappingPolicy объекту servicePrincipal . |
Список, назначенный субъекту-службе | Коллекция claimsMappingPolicy | Список объектов claimsMappingPolicy, назначенных объекту servicePrincipal . |
Отмена назначения из субъекта-службы | Нет | Удалите claimsMappingPolicy из объекта servicePrincipal . |
Свойства
Свойство | Тип | Описание |
---|---|---|
определение | Коллекция строк | Коллекция строк, содержащая строку JSON, которая определяет правила и параметры для этой политики. Дополнительные сведения о схеме JSON для этого свойства см. в разделе Свойства определения политики сопоставления утверждений. Обязательно. |
displayName | String | Отображаемое имя для этой политики. Обязательный. |
id | String | Уникальный идентификатор для этой политики. Только для чтения. |
isOrganizationDefault | Логический | Игнорировать это свойство. Политика сопоставления утверждений может применяться только к субъектам-службам и не может быть задана глобально для организации. |
Свойства определения политики сопоставления утверждений
Объект JSON, вставляемый в свойство definition , сначала должен быть преобразован в строку с экранируемыми кавычками. В этом разделе приведено несколько примеров определения.
Пример : определение для включения EmployeeID и TenantCountry в качестве утверждений в маркерах
{
"definition": [
"{\"ClaimsMappingPolicy\":{\"Version\":1,\"IncludeBasicClaimSet\":\"true\",\"ClaimsSchema\": [{\"Source\":\"user\",\"ID\":\"employeeid\",\"SamlClaimType\":\"http://schemas.xmlsoap.org/ws/2005/05/identity/claims/name\",\"JwtClaimType\":\"name\"},{\"Source\":\"company\",\"ID\":\"tenantcountry\",\"SamlClaimType\":\"http://schemas.xmlsoap.org/ws/2005/05/identity/claims/country\",\"JwtClaimType\":\"country\"}]}}"
],
"displayName": "Test1234"
}
Пример : определение , использующее преобразование утверждений
{
"definition": [
"{\"ClaimsMappingPolicy\":{\"Version\":1,\"IncludeBasicClaimSet\":\"true\",\"ClaimsSchema\": [{\"Source\":\"user\",\"ID\":\"userprincipalname\",\"SamlClaimType\":\"http://schemas.xmlsoap.org/ws/2005/05/identity/claims/nameidentifier\"},{\"Source\":\"user\",\"ID\":\"givenname\",\"SamlClaimType\":\"http://schemas.xmlsoap.org/ws/2005/05/identity/claims/givenname\"},{\"Source\":\"user\",\"ID\":\"displayname\",\"SamlClaimType\":\"http://schemas.xmlsoap.org/ws/2005/05/identity/claims/name\"},{\"Source\":\"user\",\"ID\":\"surname\",\"SamlClaimType\":\"http://schemas.xmlsoap.org/ws/2005/05/identity/claims/surname\"},{\"Source\":\"user\",\"ID\":\"userprincipalname\",\"SamlClaimType\":\"username\"}],\"ClaimsTransformation\":[{\"ID\":\"CreateTermsOfService\",\"TransformationMethod\":\"CreateStringClaim\",\"InputParameters\": [{\"ID\":\"value\",\"DataType\":\"string\", \"Value\":\"sandbox\"}],\"OutputClaims\":[{\"ClaimTypeReferenceId\":\"TOS\",\"TransformationClaimType\":\"createdClaim\"}]}]}}"
],
"displayName": "Test1234"
}
Свойство | Тип | Описание |
---|---|---|
ClaimsSchema | Объект JSON | Определяет, какие утверждения присутствуют в маркерах, на которые влияет политика, в дополнение к базовому набору утверждений и набору основных утверждений. Для каждой записи схемы утверждений, определенной в этом свойстве, требуются определенные сведения. Укажите, откуда поступают данные (пара "Значение" или "Источник-идентификатор") и утверждение, в котором данные выдаются как (тип утверждения). Не более 50 утверждений включаются в маркер через объект ClaimsSchema. Все записи схемы утверждений, возникающие после достижения ограничения, будут игнорироваться и не будут отображаться в выданном маркере. Дополнительные сведения см. в определении ClaimsSchema. |
ClaimsTransformation | Объект JSON | Определяет общие преобразования, которые можно применить к исходным данным для создания выходных данных для утверждений, указанных в ClaimsSchema. Через объект ClaimsTransformation в маркер включается не более 50 преобразований. Все преобразования, возникающие после достижения ограничения, будут игнорироваться и не будут отображаться в выданном маркере. Дополнительные сведения о ClaimsTransformation и поддерживаемых функциях см. в разделе Преобразование утверждений. |
IncludeBasicClaimSet | Логический | Если задано значение true , все утверждения в базовом наборе утверждений создаются в маркерах, на которые влияет политика. Если задано значение false , утверждения в базовом наборе утверждений не входят в маркеры, если они не добавляются по отдельности в свойство ClaimsSchema той же политики. |
Версия | Integer | Задайте значение 1. Обязательный. |
Связи
Связь | Тип | Описание |
---|---|---|
appliesTo | Коллекция directoryObject | Коллекция directoryObject , к которому применена эта политика. Только для чтения. |
Представление JSON
В следующем представлении JSON показан тип ресурса.
{
"definition": ["String"],
"displayName": "String",
"id": "String (identifier)",
"isOrganizationDefault": false,
}