accessPackageResourceAttribute-Ressourcentyp

Namespace: microsoft.graph

Wichtig

APIs unter der /beta Version in Microsoft Graph können geändert werden. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in Version 1.0 verfügbar ist, verwenden Sie die Versionsauswahl .

Ein Ressourcenattribut des Zugriffspakets ist die Definition einer Eigenschaft, die ein Benutzer benötigt, um auf eine Anwendung zugreifen zu können. Diese Struktur ist in einer accessPackageResource eines Katalogs für eine Anwendung enthalten, deren Rollen in einem Zugriffspaket in diesem Katalog enthalten sind. Wenn ein Benutzer das Zugriffspaket anfordert, muss er den Wert des Attributs angeben, das, wenn die Anforderung genehmigt wird, dann in das Verzeichnisobjekt des Benutzers geschrieben wird. Anschließend kann die Anwendung das Attribut des Benutzers lesen.

Eigenschaften

Eigenschaft	Typ	Beschreibung
attributeDestination	accessPackageResourceAttributeDestination	Informationen zum Festlegen des Attributs, derzeit ein accessPackageUserDirectoryAttributeStore-Objekttyp .
Attributename	String	Der Name des Attributs im Endsystem. Wenn das Ziel ist accessPackageUserDirectoryAttributeStore, dann eine Benutzereigenschaft wie jobTitle oder eine Verzeichnisschemaerweiterung für den Benutzerobjekttyp, z extension_2b676109c7c74ae2b41549205f1947ed_personalTitle. B. .
attributeSource	accessPackageResourceAttributeSource	Informationen zum Auffüllen des Attributwerts, wenn ein accessPackageAssignmentRequest erfüllt wird, derzeit ein accessPackageResourceAttributeQuestion-Objekttyp .
id	Zeichenfolge	Eindeutiger Bezeichner für das Attribut in der Zugriffspaketressource. Schreibgeschützt.
Iseditable	Zeichenfolge	Gibt an, ob ein vorhandener Attributwert vom Anforderer bearbeitet werden kann.
isPersistedOnAssignmentRemoval	Boolescher Wert	Gibt an, ob das Attribut im Endsystem verbleibt, nachdem eine Zuordnung beendet wurde.

accessPackageResourceAttribute-Ressourcentyp und Erweiterungseigenschaften

Die Attribute "attributeDestination", " attributeName" und " attributeSource " eines Ressourcenattributs für Zugriffspakete beziehen sich auf die Verzeichniserweiterungseigenschaften.

Wenn die attributeDestination ein accessPackageUserDirectoryAttributeStore-Objekttyp ist, muss das durch attributeName angegebene Attribut eine schreibbare Eigenschaft des Benutzerobjekts sein. Diese schreibbaren Eigenschaften sind Zeichenfolgentypen, die als Erweiterungseigenschaften für das Zielbenutzerobjekt registriert sind.

Angenommen, eine Anwendung erfordert zwei Benutzerattribute, die Position eines Benutzers und seine persönliche Position. Die Werte dieser Attribute können mit Azure AD aus den lokalen Attributen "Active Directory jobTitle" und "personalTitle" synchronisiert werden. Da personalTitle nicht zu den Standardeigenschaften des Benutzerobjekts gehört, müsste hierfür eine Verzeichnisschemaerweiterung erstellt werden, um die personalTitle-Eigenschaft dem Benutzerobjekttyp hinzuzufügen. Beim Erstellen einer Ressourcenanforderung für die Anwendung können Sie zwei Zugriffspaketressourcenattribute einschließen, eines für den BenutzereigenschaftsauftragTitle und ein weiteres mit dem Namen der Verzeichnisschemaerweiterungseigenschaft, die für den persönlichen Titel erstellt wurde, z extension_2b676109c7c74ae2b41549205f1947ed_personalTitle. B. .

Wenn die attributeSource des Attributs eine accessPackageResourceAttributeQuestion ist, wird der angegebene Wert des Anforderers wie im Benutzerobjekt bereitgestellt gespeichert und der Anwendung und anderen Microsoft Graph-Clients zur Verfügung gestellt.

Beziehungen

Keine.

JSON-Darstellung

Es folgt eine JSON-Darstellung der Ressource.

{
  "@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"
}