Element uživatelského rozhraní Microsoft.Common.ServicePrincipalSelector

Ovládací prvek, který umožňuje uživatelům vybrat existující instanční objekt nebo zaregistrovat novou aplikaci. Když vyberete Vytvořit nový, postupujte podle pokynů k registraci nové aplikace. Když vyberete existující aplikaci, ovládací prvek poskytne textové pole pro zadání hesla nebo kryptografického otisku certifikátu.

Ukázky uživatelského rozhraní

Můžete použít výchozí aplikaci, vytvořit novou aplikaci nebo použít existující aplikaci.

Použít výchozí aplikaci nebo vytvořit novou

Výchozí zobrazení je určeno hodnotami ve defaultValue vlastnosti a typ instančního objektu je nastaven na Vytvořit nový. principalId Pokud vlastnost obsahuje platný globálně jedinečný identifikátor (GUID), ovládací prvek vyhledá aplikaci objectId. Výchozí hodnota se použije, pokud uživatel nevybere ovládací prvek.

Pokud chcete zaregistrovat novou aplikaci, vyberte Změnit výběr a zobrazí se dialogové okno Zaregistrovat aplikaci . Zadejte název, typ podporovaného účtu a vyberte tlačítko Zaregistrovat .

Po registraci nové aplikace použijte typ ověřování k zadání hesla nebo kryptografického otisku certifikátu.

Použití existující aplikace

Pokud chcete použít existující aplikaci, zvolte Vybrat existující a pak vyberte Vybrat. Pomocí dialogového okna Vybrat aplikaci vyhledejte název aplikace. Ve výsledcích vyberte aplikaci a pak tlačítko Vybrat . Po výběru aplikace ovládací prvek zobrazí typ ověřování pro zadání hesla nebo kryptografického otisku certifikátu.

Schéma

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

Poznámky

• Požadované vlastnosti jsou následující:

  • name
  • type
  • label
  • defaultValue: Určuje výchozí hodnotu principalId a name.

• Volitelné vlastnosti jsou následující:

  • toolTip: Připojí popisek infoBalloon ke každému popisku.
  • visible: Skryjte nebo zobrazte ovládací prvek.
  • options: Určuje, zda má být k dispozici možnost kryptografického otisku certifikátu.
  • constraints: Omezení regulárních výrazů pro ověření hesla.

Příklad

Následující kód je příkladem Microsoft.Common.ServicePrincipalSelector ovládacího prvku. Vlastnost defaultValue se nastaví principalId jako <default guid> zástupný symbol pro identifikátor GUID výchozího identifikátoru aplikace.

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

Příklad výstupu

Je appId ID registrace aplikace, kterou jste vybrali nebo vytvořili. Jedná se objectId o pole ID objektů pro instanční objekty nakonfigurované pro vybranou registraci aplikace.

Pokud z ovládacího prvku není proveden žádný výběr, newOrExisting hodnota vlastnosti je nová:

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

Při vytvoření nové nebo existující aplikace je vybrána z ovládacího prvku newOrExisting hodnota vlastnosti je existující:

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

Další kroky

• Úvod k vytváření definic uživatelského rozhraní najdete v tématu Začínáme s CreateUiDefinition.
• Popis běžných vlastností elementů uživatelského rozhraní naleznete v tématu CreateUiDefinition elementy.