Microsoft.Common.ServicePrincipalSelector UI-element

En kontroll som låter användare välja ett befintligt huvudnamn för tjänsten eller registrera ett nytt program. När du väljer Skapa ny följer du stegen för att registrera ett nytt program. När du väljer ett befintligt program tillhandahåller kontrollen en textruta för att ange ett lösenord eller certifikatets tumavtryck.

Exempel på användargränssnitt

Du kan använda ett standardprogram, skapa ett nytt program eller använda ett befintligt program.

Använd standardprogrammet eller skapa nytt

Standardvyn bestäms av värdena i egenskapen och tjänstens huvudnamnstyp är inställd på Skapa ny.defaultValue Om egenskapen principalId innehåller en giltig globalt unik identifierare (GUID) söker kontrollen efter programmets objectId. Standardvärdet gäller om användaren inte gör något val från kontrollen.

Om du vill registrera ett nytt program väljer du Ändra val och dialogrutan Registrera ett program visas. Ange Namn, kontotyp som stöds och välj knappen Registrera .

När du har registrerat ett nytt program använder du autentiseringstypen för att ange ett lösenord eller certifikatets tumavtryck.

Använda befintligt program

Om du vill använda ett befintligt program väljer du Välj befintlig och sedan Välj. Använd dialogrutan Välj ett program för att söka efter programmets namn. I resultaten väljer du programmet och sedan knappen Välj . När du har valt ett program visar kontrollen Autentiseringstyp för att ange ett lösenord eller certifikatets tumavtryck.

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
}

Kommentarer

• De nödvändiga egenskaperna är följande:

  • name
  • type
  • label
  • defaultValue: Anger standardvärdet principalId och name.

• De valfria egenskaperna är följande:

  • toolTip: Bifogar en knappbeskrivning infoBalloon till varje etikett.
  • visible: Dölj eller visa kontrollen.
  • options: Anger om tumavtrycksalternativet för certifikatet ska göras tillgängligt eller inte.
  • constraints: Regex-begränsningar för lösenordsverifiering.

Exempel

Följande kod är ett exempel på Microsoft.Common.ServicePrincipalSelector kontrollen. Egenskapen defaultValue anges principalId till <default guid> som platshållare för ett GUID för standardprogramidentifierare.

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

Exempel på utdata

appId är ID:t för den programregistrering som du har valt eller skapat. objectId är en matris med objekt-ID:er för tjänstens huvudnamn som konfigurerats för den valda programregistreringen.

När ingen markering görs från kontrollen är egenskapsvärdet newOrExisting nytt:

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

När Skapa nytt eller ett befintligt program väljs från kontrollen är egenskapsvärdet newOrExisting befintligt:

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

Nästa steg

• En introduktion till hur du skapar användargränssnittsdefinitioner finns i Komma igång med CreateUiDefinition.
• En beskrivning av vanliga egenskaper i gränssnittselement finns i CreateUiDefinition-element.