тип ресурса accessPackageResourceAttribute

Статья
10/18/2023

Пространство имен: microsoft.graph

Важно!

API версии /beta в Microsoft Graph могут быть изменены. Использование этих API в производственных приложениях не поддерживается. Чтобы определить, доступен ли API в версии 1.0, используйте селектор версий.

Атрибут ресурса пакета доступа — это определение свойства, которое требуется пользователю для доступа к приложению. Эта структура включается в accessPackageResource каталога для приложения, роли которого включены в пакет доступа в этом каталоге. Когда пользователь запрашивает пакет доступа, он должен указать значение атрибута, которое, если запрос утвержден, записывается в объект каталога пользователя. Затем приложение может считывать атрибут пользователя.

Свойства

Свойство	Тип	Описание
attributeDestination	accessPackageResourceAttributeDestination	Сведения о том, как задать атрибут, в настоящее время — тип объекта accessPackageUserDirectoryAttributeStore .
attributeName	String	Имя атрибута в конечной системе. Если назначение — `accessPackageUserDirectoryAttributeStore`, то свойство пользователя, например jobTitle , или расширение схемы каталога для типа объекта пользователя, например `extension_2b676109c7c74ae2b41549205f1947ed_personalTitle`.
attributeSource	accessPackageResourceAttributeSource	Сведения о том, как заполнять значение атрибута при выполнении объекта accessPackageAssignmentRequest , в настоящее время — тип объекта accessPackageResourceAttributeQuestion .
id	String	Уникальный идентификатор атрибута в ресурсе пакета доступа. Только для чтения.
isEditable	String	Указывает, может ли запрашивающий изменить существующее значение атрибута.
isPersistedOnAssignmentRemoval	Логический	Указывает, останется ли атрибут в конечной системе после окончания назначения.

тип ресурса accessPackageResourceAttribute и свойства расширения

Свойства attributeDestination, attributeName и attributeSource атрибута ресурса пакета доступа относятся к свойствам расширения каталога.

Если attributeDestination является типом объекта accessPackageUserDirectoryAttributeStore , атрибут, указанный атрибутом attributeName , должен быть записываемым свойством объекта user . Эти записываемые свойства — это типы строк, зарегистрированные как свойства расширения в целевом объекте User .

Например, предположим, что приложению требуются два атрибута пользователя: должность пользователя и его личное название. Значения этих атрибутов можно синхронизировать с Microsoft Entra ID из атрибутов локальная служба Active Directory jobTitle и personalTitle. Так как personalTitle не является одним из свойств объекта пользователя по умолчанию, для этого потребуется создать расширение схемы каталога для добавления свойства personalTitle в тип объекта пользователя. При создании запроса на ресурс для приложения можно включить два атрибута ресурса пакета доступа: один для свойства пользователя jobTitle, а другой — с именем свойства расширения схемы каталога, созданного для личного заголовка, например extension_2b676109c7c74ae2b41549205f1947ed_personalTitle.

Если атрибут attributeSource атрибута является accessPackageResourceAttributeQuestion, то предоставленное запрашивающее значение сохраняется в объекте пользователя и становится доступным приложению и другим клиентам Microsoft Graph.

Связи

Отсутствуют.

Представление JSON

Ниже указано представление ресурса в формате JSON.

{
  "@odata.type": "#microsoft.graph.accessPackageResourceAttribute",
  "attributeDestination": {
    "@odata.type": "microsoft.graph.accessPackageResourceAttributeDestination"
  },
  "attributeName": "String",
  "attributeSource": {
    "@odata.type": "microsoft.graph.accessPackageResourceAttributeSource"
  },
  "id": "String (identifier)",
  "isEditable": "Boolean",
  "isPersistedOnAssignmentRemoval": "Boolean"
}

Поделиться через