Microsoft.Common.ServicePrincipalSelector UI-element

Een besturingselement waarmee gebruikers een bestaande service-principal kunnen selecteren of een nieuwe toepassing kunnen registreren. Wanneer u Nieuwe maken selecteert, volgt u de stappen om een nieuwe toepassing te registreren. Wanneer u een bestaande toepassing selecteert, bevat het besturingselement een tekstvak voor het invoeren van een wachtwoord of certificaatvingerafdruk.

Voorbeelden van gebruikersinterface

U kunt een standaardtoepassing gebruiken, een nieuwe toepassing maken of een bestaande toepassing gebruiken.

Standaardtoepassing gebruiken of nieuwe maken

De standaardweergave wordt bepaald door de waarden in de defaultValue eigenschap en het type service-principal is ingesteld op Nieuw maken. Als de principalId eigenschap een geldige GUID (Globally Unique Identifier) bevat, zoekt het besturingselement naar de toepassing objectId. De standaardwaarde is van toepassing als de gebruiker geen selectie maakt uit het besturingselement.

Als u een nieuwe toepassing wilt registreren, selecteert u De selectie Wijzigen en wordt het dialoogvenster Een toepassing registreren weergegeven. Voer De naam, het ondersteunde accounttype in en selecteer de knop Registreren .

Nadat u een nieuwe toepassing hebt geregistreerd, gebruikt u het verificatietype om een wachtwoord of certificaatvingerafdruk in te voeren.

Bestaande toepassing gebruiken

Als u een bestaande toepassing wilt gebruiken, kiest u Bestaande selecteren en selecteert u Vervolgens Selectie maken. Gebruik het dialoogvenster Een toepassing selecteren om te zoeken naar de naam van de toepassing. Selecteer in de resultaten de toepassing en vervolgens de knop Selecteren . Nadat u een toepassing hebt geselecteerd, wordt in het besturingselement het verificatietype weergegeven om een wachtwoord of certificaatvingerafdruk in te voeren.

Schema

{
  "name": "ServicePrincipal",
  "type": "Microsoft.Common.ServicePrincipalSelector",
  "label": {
    "password": "Password",
    "certificateThumbprint": "Certificate thumbprint",
    "authenticationType": "Authentication Type",
    "sectionHeader": "Service Principal"
  },
  "toolTip": {
    "password": "Password",
    "certificateThumbprint": "Certificate thumbprint",
    "authenticationType": "Authentication Type"
  },
  "defaultValue": {
    "principalId": "<default guid>",
    "name": "(New) default App Id"
  },
  "constraints": {
    "required": true,
    "regex": "^[a-zA-Z0-9]{8,}$",
    "validationMessage": "Password must be at least 8 characters long, contain only numbers and letters"
  },
  "options": {
    "hideCertificate": false
  },
  "visible": true
}

Opmerkingen

• De vereiste eigenschappen zijn als volgt:

  • name
  • type
  • label
  • defaultValue: Hiermee geeft u de standaardinstelling principalId en name.

• De optionele eigenschappen zijn als volgt:

  • toolTip: Hiermee voegt u knopinfo infoBalloon toe aan elk label.
  • visible: Het besturingselement verbergen of weergeven.
  • options: Hiermee geeft u op of de vingerafdrukoptie van het certificaat beschikbaar moet worden gesteld.
  • constraints: Regex-beperkingen voor wachtwoordvalidatie.

Opmerking

Hier volgt een voorbeeld van het Microsoft.Common.ServicePrincipalSelector besturingselement. De defaultValue eigenschap wordt ingesteld <default guid>principalId als tijdelijke aanduiding voor een standaard-GUID voor de toepassings-id.

{
  "$schema": "https://schema.management.azure.com/schemas/0.1.2-preview/CreateUIDefinition.MultiVm.json#",
  "handler": "Microsoft.Azure.CreateUIDef",
  "version": "0.1.2-preview",
  "parameters": {
    "basics": [],
    "steps": [
      {
        "name": "SPNcontrol",
        "label": "SPNcontrol",
        "elements": [
          {
            "name": "ServicePrincipal",
            "type": "Microsoft.Common.ServicePrincipalSelector",
            "label": {
              "password": "Password",
              "certificateThumbprint": "Certificate thumbprint",
              "authenticationType": "Authentication Type",
              "sectionHeader": "Service Principal"
            },
            "toolTip": {
              "password": "Password",
              "certificateThumbprint": "Certificate thumbprint",
              "authenticationType": "Authentication Type"
            },
            "defaultValue": {
              "principalId": "<default guid>",
              "name": "(New) default App Id"
            },
            "constraints": {
              "required": true,
              "regex": "^[a-zA-Z0-9]{8,}$",
              "validationMessage": "Password must be at least 8 characters long, contain only numbers and letters"
            },
            "options": {
              "hideCertificate": false
            },
            "visible": true
          }
        ]
      }
    ],
    "outputs": {
      "appId": "[steps('SPNcontrol').ServicePrincipal.appId]",
      "objectId": "[steps('SPNcontrol').ServicePrincipal.objectId]",
      "password": "[steps('SPNcontrol').ServicePrincipal.password]",
      "certificateThumbprint": "[steps('SPNcontrol').ServicePrincipal.certificateThumbprint]",
      "newOrExisting": "[steps('SPNcontrol').ServicePrincipal.newOrExisting]",
      "authenticationType": "[steps('SPNcontrol').ServicePrincipal.authenticationType]"
    }
  }
}

Voorbeelduitvoer

Dit appId is de id van de toepassingsregistratie die u hebt geselecteerd of gemaakt. Dit objectId is een matrix met object-id's voor de service-principals die zijn geconfigureerd voor de geselecteerde toepassingsregistratie.

Wanneer er geen selectie wordt gemaakt op basis van het besturingselement, is de newOrExisting eigenschapswaarde nieuw:

{
  "appId": {
    "value": "<default guid>"
  },
  "objectId": {
    "value": ["<default guid>"]
  },
  "password": {
    "value": "<password>"
  },
  "certificateThumbprint": {
    "value": ""
  },
  "newOrExisting": {
    "value": "new"
  },
  "authenticationType": {
    "value": "password"
  }
}

Wanneer Nieuwe maken of een bestaande toepassing is geselecteerd vanuit het besturingselement, is de newOrExisting eigenschapswaarde bestaand:

{
  "appId": {
    "value": "<guid>"
  },
  "objectId": {
    "value": ["<guid>"]
  },
  "password": {
    "value": "<password>"
  },
  "certificateThumbprint": {
    "value": ""
  },
  "newOrExisting": {
    "value": "existing"
  },
  "authenticationType": {
    "value": "password"
  }
}

Volgende stappen

• Zie Aan de slag met CreateUiDefinition voor een inleiding tot het maken van UI-definities.
• Zie CreateUiDefinition-elementen voor een beschrijving van algemene eigenschappen in UI-elementen.