Elemento de interfaz de usuario Microsoft.Common. ServicePrincipalSelector

Control que permite a los usuarios seleccionar una entidad de servicio o registrar una aplicación nueva. Al seleccionar Crear nuevo, se recorren los pasos para registrar una nueva aplicación. Al seleccionar una aplicación existente, el control proporciona un cuadro de texto para escribir una contraseña o una huella digital de certificado.

Ejemplos de interfaz de usuario

Puede usar una aplicación predeterminada, crear una nueva aplicación o utilizar una aplicación existente.

Uso de una aplicación predeterminada o creación de una nueva

La vista predeterminada la definen los valores de la propiedad defaultValue y el tipo de entidad de servicio se establece en Crear nueva. Si la propiedad principalId contiene un identificador único global (GUID) válido, el control busca el elemento objectId de la aplicación. El valor predeterminado se aplica si el usuario no realiza una selección en el control.

Si quiere registrar una nueva aplicación, seleccione Cambiar selección y se mostrará el cuadro de diálogo Registrar una aplicación. Escriba el nombre, el tipo de cuenta admitida y pulse el botón Registrar.

Después de registrar una nueva aplicación, use el Tipo de autenticación para escribir una contraseña o una huella digital de certificado.

Uso de la aplicación existente

Para usar una aplicación existente, pulse Seleccionar existentes y, a continuación, Hacer la selección. Use el cuadro de diálogo Seleccionar una aplicación para buscar el nombre de la aplicación. En los resultados, seleccione la aplicación y, después, el botón Seleccionar. Después de seleccionar una aplicación, el control muestra el tipo de autenticación para escribir una contraseña o una huella digital de certificado.

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
}

Observaciones

• Las propiedades necesarias son las siguientes:

  • name
  • type
  • label
  • defaultValue: especifica los valores de principalId y name predeterminados.

• Las propiedades opcionales son las siguientes:

  • toolTip: Adjunta una información sobre herramientas infoBalloon a cada etiqueta.
  • visible: Oculte o muestre el control.
  • options: Especifica si la opción de huella digital del certificado debe estar disponible.
  • constraints: Restricciones regex para la validación de contraseñas.

Ejemplo

El código siguiente es un ejemplo del Microsoft.Common.ServicePrincipalSelector control . La propiedad defaultValue establece principalId en <default guid> como un marcador de posición para un GUID de identificador de aplicación predeterminado.

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

Salida de ejemplo

appId es el identificador del registro de la aplicación que seleccionó o creó. objectId es una matriz de los id. de objeto correspondientes a las entidades de servicio configuradas para el registro de la aplicación seleccionada.

Cuando no se realiza ninguna selección desde el control, el valor de la propiedad newOrExisting es nuevo:

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

Cuando se selecciona Crear nueva o una aplicación existente en el control, el valor de la propiedad newOrExisting es existente:

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

Pasos siguientes

• Para ver una introducción sobre la creación de definiciones de interfaz de usuario, consulte Introducción a CreateUiDefinition.
• Para ver una descripción de las propiedades comunes de los elementos de interfaz de usuario, consulte Elementos CreateUiDefinition.