accessPackageResourceAttribute-Ressourcentyp

Namespace: microsoft.graph

Wichtig

Die APIs unter der /beta Version in Microsoft Graph können sich ändern. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in v1.0 verfügbar ist, verwenden Sie die Version Selektor.

Ein Zugriffspaketressourcen-Attribut 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, 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	Zeichenfolge	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 eine accessPackageAssignmentRequest erfüllt wird, derzeit ein accessPackageResourceAttributeQuestion-Objekttyp .
id	Zeichenfolge	Eindeutiger Bezeichner für das Attribut für die Zugriffspaketressource. Schreibgeschützt.
isEditable	Zeichenfolge	Gibt an, ob ein vorhandener Attributwert vom anfordernden Benutzer bearbeitet werden kann.
isPersistedOnAssignmentRemoval	Boolesch	Gibt an, ob das Attribut nach dem Ende einer Zuweisung im Endsystem verbleibt.

accessPackageResourceAttribute-Ressourcentyp und Erweiterungseigenschaften

Die Eigenschaften attributeDestination, attributeName und attributeSource eines Zugriffspaketressourcenattributes beziehen sich auf die Verzeichniserweiterungseigenschaften.

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

Angenommen, eine Anwendung erfordert zwei Benutzerattribute, die Position eines Benutzers und seine persönliche Titel. Die Werte dieser Attribute können aus den lokalen Active Directory-Attributen jobTitle und personalTitle mit der Microsoft Entra-ID synchronisiert werden. Da personalTitle keine der Standardeigenschaften des Benutzerobjekts ist, muss hierfür eine Verzeichnisschemaerweiterung erstellt werden, um dem Benutzerobjekttyp die eigenschaft personalTitle hinzuzufügen. Beim Erstellen einer Ressourcenanforderung für die Anwendung können Sie zwei Zugriffspaketressourcenattribute einschließen, eines für die Benutzereigenschaft jobTitle und ein weiteres mit dem Namen der Verzeichnisschemaerweiterungseigenschaft, die für den persönlichen Titel erstellt wurde, z extension_2b676109c7c74ae2b41549205f1947ed_personalTitle. B. .

Wenn das attributSource des Attributs ein accessPackageResourceAttributeQuestion ist, wird der angegebene Wert des Anforderers wie im Benutzerobjekt angegeben gespeichert und der Anwendung und anderen Microsoft Graph-Clients zur Verfügung gestellt.

Beziehungen

Keine.

JSON-Darstellung

Die folgende JSON-Darstellung zeigt den Ressourcentyp.

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