Elemento Microsoft.Common.ServicePrincipalSelector dell'interfaccia utente

Controllo che consente agli utenti di selezionare un'entità servizio esistente o registrare una nuova applicazione. Quando si seleziona Crea nuova, seguire la procedura per registrare una nuova applicazione. Quando si seleziona un'applicazione esistente, il controllo fornisce una casella di testo per immettere una password o un'identificazione personale del certificato.

Esempi di interfaccia utente

È possibile usare un'applicazione predefinita, creare una nuova applicazione o usare un'applicazione esistente.

Usare l'applicazione predefinita o crearne una nuova

La visualizzazione predefinita è determinata dai valori nella proprietà defaultValue e il tipo di entità servizio è impostato su Crea nuova. Se la proprietà principalId contiene un identificatore univoco globale (GUID) valido, il controllo cerca l'elemento objectId dell'applicazione. Il valore predefinito si applica se l'utente non effettua una selezione dal controllo.

Per registrare una nuova applicazione, selezionare Modifica selezione. Verrà visualizzata la finestra di dialogo Registra un'applicazione. Immettere Nome, Tipo di account supportato e selezionare il pulsante Registra.

Dopo aver registrato una nuova applicazione, usare Tipo di autenticazione per immettere una password o un'identificazione personale del certificato.

Usare un'applicazione esistente

Per usare un'applicazione esistente, scegliere Seleziona esistente e quindi Effettua selezione. Usare la finestra di dialogo Selezionare un'applicazione per cercare il nome dell'applicazione. Nei risultati selezionare l'applicazione e quindi il pulsante Seleziona. Dopo aver selezionato un'applicazione, il controllo visualizza Tipo di autenticazione per immettere una password o un'identificazione personale del certificato.

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
}

Osservazioni:

• Le proprietà obbligatorie sono le seguenti:

  • name
  • type
  • label
  • defaultValue specifica i valori predefiniti per principalId e name.

• Le proprietà facoltative sono le seguenti:

  • toolTip: associa una descrizione comando infoBalloon a ogni etichetta.
  • visible: nasconde o visualizza il controllo.
  • options: specifica se l'opzione di identificazione personale del certificato deve essere resa disponibile o meno.
  • constraints: vincoli dell'espressione regolare per la convalida delle password.

Esempio

Di seguito è riportato un esempio del controllo Microsoft.Common.ServicePrincipalSelector. La proprietà defaultValue imposta principalId su <default guid> come segnaposto per un GUID dell'identificatore dell'applicazione predefinito.

{
  "$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]"
    }
  }
}

Output di esempio

appId è l'ID della registrazione dell'applicazione selezionata o creata. objectId è una matrice di ID oggetto per le entità servizio configurate per la registrazione dell'applicazione selezionata.

Quando non viene effettuata alcuna selezione dal controllo, il valore della proprietà newOrExisting è new:

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

Quando si seleziona Crea nuova o un'applicazione esistente dal controllo il valore della proprietà newOrExisting è existing:

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

Passaggi successivi

• Per un'introduzione alla creazione delle definizioni dell'interfaccia utente, vedere Introduzione a CreateUiDefinition.
• Per una descrizione delle proprietà comuni negli elementi dell'interfaccia utente, vedere Elementi di CreateUiDefinition.