Microsoft.Common.ServicePrincipalSelector felhasználói felületi elem

Egy vezérlő, amellyel a felhasználók kiválaszthatnak egy meglévő szolgáltatásnevet , vagy regisztrálhatnak egy új alkalmazást. Amikor az Új létrehozása lehetőséget választja, a lépéseket követve regisztrálhat egy új alkalmazást. Meglévő alkalmazás kiválasztásakor a vezérlő egy szövegmezőt biztosít egy jelszó vagy tanúsítvány ujjlenyomatának megadásához.

Felhasználói felületi minták

Használhat alapértelmezett alkalmazást, létrehozhat új alkalmazást, vagy használhat egy meglévő alkalmazást.

Alapértelmezett alkalmazás használata vagy új létrehozása

Az alapértelmezett nézetet a defaultValue tulajdonság értékei határozzák meg, a Szolgáltatásnév típusa pedig Új létrehozása értékre van állítva. Ha a principalId tulajdonság érvényes globálisan egyedi azonosítót (GUID) tartalmaz, a vezérlő megkeresi az alkalmazás objectId. Az alapértelmezett érték akkor érvényes, ha a felhasználó nem jelöl ki kijelölést a vezérlőből.

Ha új alkalmazást szeretne regisztrálni, válassza a Kijelölés módosítása lehetőséget, és megjelenik az Alkalmazás regisztrálása párbeszédpanel. Adja meg a Nevet, a Támogatott fiók típusát, majd kattintson a Regisztráció gombra.

Az új alkalmazás regisztrálása után a hitelesítési típussal adja meg a jelszót vagy a tanúsítvány ujjlenyomatát.

Meglévő alkalmazás használata

Meglévő alkalmazás használatához válassza a Meglévő kiválasztása, majd a Kijelölés létrehozása lehetőséget. Az alkalmazás nevének kereséséhez használja az Alkalmazás kiválasztása párbeszédpanelt. Az eredmények közül válassza ki az alkalmazást, majd a Kiválasztás gombot. Miután kiválasztott egy alkalmazást, a vezérlő megjeleníti a hitelesítési típust egy jelszó vagy tanúsítvány ujjlenyomatának megadásához.

Sé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
}

Megjegyzések

• A szükséges tulajdonságok a következők:

  • name
  • type
  • label
  • defaultValue: Az alapértelmezett principalId és namea .

• Az opcionális tulajdonságok a következők:

  • toolTip: Elemleírást infoBalloon csatol minden címkéhez.
  • visible: A vezérlő elrejtése vagy megjelenítése.
  • options: Megadja, hogy elérhetővé kell-e tenni a tanúsítvány ujjlenyomat-beállítását.
  • constraints: A jelszó-ellenőrzés regex korlátozásai.

Példa

Az alábbi kód egy példa a vezérlőre Microsoft.Common.ServicePrincipalSelector . A defaultValue tulajdonság helyőrzőként van bekapcsolva principalId <default guid> az alapértelmezett alkalmazásazonosító GUID-azonosítójaként.

{
  "$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éldakimenet

A appId kiválasztott vagy létrehozott alkalmazásregisztráció azonosítója. Ez objectId a kiválasztott alkalmazásregisztrációhoz konfigurált szolgáltatásnevek objektumazonosítóinak tömbje.

Ha nincs kijelölés a vezérlőből, a newOrExisting tulajdonság értéke új:

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

Ha újat hoz létre, vagy egy meglévő alkalmazás van kiválasztva a vezérlőelemből, a newOrExisting tulajdonság értéke már létezik:

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

Következő lépések

• A felhasználói felületi definíciók létrehozásának bemutatása: A CreateUiDefinition használatának első lépései.
• A felhasználói felület elemeinek gyakori tulajdonságairól a CreateUiDefinition elemek című témakörben olvashat.