Aangepaste kenmerken maken met het gebruikersschema

Voor sommige vooraf ingestelde SAML-apps moet u een aangepast kenmerk toevoegen aan een gebruiker. U kunt het schema gebruiken om het gebruikersprofiel te updaten met deze kenmerken die u maakt. De voorbeelden hieronder zijn afgestemd op de Amazon Web Services-cloud-app. Ze bevatten verwijzingen naar de Role ARN en Provider ARN, die specifiek zijn voor Amazon Web Services.

Een aangepast schema maken

  1. Open de pagina Schema insert (Schema toevoegen).
  2. Voer in het veld customerId (klantID) 'my_customer' in.

  3. Plak de volgende tekst in het gedeelte Request body:

    {
  "fields":
  [
    {
      "fieldName": "role",
      "fieldType": "STRING",
      "readAccessType": "ADMINS_AND_SELF",
      "multiValued": true,
      "displayName": "role"
    }
  ],
  "schemaName": "SSO"
  "displayName": "Amazon"
}

    Opmerkingen:

    • Hoewel schemaName normaal gesproken elke tekstwaarde kan zijn, is de specifieke waarde 'SSO' vereist als u een aangepast schema instelt voor gebruik met de Amazon Web Services-cloud-app.
    • Als u meer dan één rol wilt gebruiken, stelt u multiValued in op 'true'.

  4. Klik op Execute (Uitvoeren).

  5. Toegang tot de Directory API autoriseren.

    U krijgt een reactie 200 OK en de uitvoer van het verzoek wordt getoond.

Aangepaste gegevens toevoegen aan een gebruikersprofiel

  1. Open de pagina voor gebruikersupdates.
  2. Voer onder userKey het e-mailadres in van de Google-gebruiker van wie u het profiel wilt updaten. (U kunt ook een e-mailalias of unieke gebruikers-ID gebruiken. Ga naar de documentatie van de Directory API voor meer informatie.)

  3. Plak de volgende tekst in het gedeelte Verzoektekst en vervang <role ARN> en <provider ARN> door de juiste waarden, die beschikbaar zijn in het artikel over de Amazon Web Services-cloud-app.

    Opmerking: Als het aangepaste veld type is ingesteld op custom, moet u ook de parameter customType gebruiken. Deze moet worden ingesteld op een waarde om te voorkomen dat er een fout wordt geretourneerd.

    {
  "customSchemas":
  {
    "SSO":
    {
      "role": [
      {
       "value": "<role ARN>,<provider ARN>",
       "type": "custom"
       "customType": "SSO"

      }
     ]
    }
  }
}

  4. (Optioneel) Als u toegang wilt geven tot meer dan één rol, voegt u waarden toe binnen de {}, gescheiden door een komma (,).

    • U kunt alleen meerdere rollen instellen als u multiValued instelt op true wanneer u het schema maakt.
    • Als er meerdere rollen beschikbaar zijn, wordt de gebruiker gevraagd welke rol die wil gebruiken.

    In dit voorbeeld zijn de 2 rollen SSO en tester:

    {
  "customSchemas":
  {
    "SSO":
    {
      "role": [
      {
       "value": "arn:aws:iam::038047464115:role/SSO,arn:aws:iam::038047464115:saml-provider/Google",
       "type": "custom"
       "customType": "SSO"
      },
      {
       "value": "arn:aws:iam::038047464115:role/tester,arn:aws:iam::038047464115:saml-provider/Google",
       "type": "custom"
       "customType": "tester"
      }
     ]
    }
  }
}

  5. Klik op Execute (Uitvoeren).

  6. Toegang tot de Directory API autoriseren.

    U krijgt de reactie 200 OK en het gebruikersprofiel wordt geüpdatet met de aangepaste gegevens.