Extender esquema

En este documento, se explica cómo extender el esquema en una instancia de Managed Service para Microsoft Active Directory.

Antes de comenzar

Antes de comenzar, haz lo siguiente:

  1. Cree un dominio de Managed Microsoft AD.
  2. Crea una VM de Windows y únela al dominio.
  3. Asegúrate de consultar el artículo Acerca de la extensión de esquema y comprender estas consideraciones.
  4. Prepara el archivo LDIF con los cambios de esquema. Para obtener más información, consulta Cómo preparar el archivo LDIF.

  5. Asegúrate de tener alguno de los siguientes roles de usuario de Identity and Access Management (IAM):

    • Administrador de dominios de identidades administradas de Google Cloud (roles/managedidentities.domainAdmin)
    • Administrador de identidades administradas de Google Cloud (roles/managedidentities.admin)

    Para obtener más información, consulta Funciones de identidades administradas de Cloud.

Extiende el esquema

Cuando inicias la extensión de esquema, Microsoft AD administrado crea una copia de seguridad de extensión de esquema automáticamente antes de aplicar los cambios de esquema. Puedes usar esta copia de seguridad para restablecer el dominio si tienes algún problema después de la extensión de esquema. Para identificar la copia de seguridad de la extensión de esquema, puedes enumerar las copias de seguridad creadas para tu dominio.

Para extender el esquema, ejecuta el siguiente comando de gcloud CLI:

gcloud active-directory domains extend-schema DOMAIN_NAME  --ldif-file=LDIF_FILE_PATH \
    --description=SCHEMA_EXTENSION_DESCRIPTION --project=DOMAIN_RESOURCE_PROJECT_ID --async

Reemplaza lo siguiente:

  • DOMAIN_NAME: Es el nombre de tu dominio de Microsoft AD administrado. Por ejemplo, my-domain.example.com
  • LDIF_FILE_PATH: La ruta de acceso del archivo LDIF con el esquema cambia. El tamaño máximo del archivo se limita a 1 MB.
  • SCHEMA_EXTENSION_DESCRIPTION: La descripción del esquema cambia.
  • DOMAIN_RESOURCE_PROJECT_ID: Es el ID del proyecto del recurso del dominio. Por ejemplo, my-project

Microsoft AD administrado inicia la extensión del esquema y responde con un ID de operación que puedes usar para hacer un seguimiento de que se completó la extensión del esquema.

Para verificar el estado de la extensión de esquema, ejecuta el siguiente comando de gcloud CLI:

gcloud active-directory operations describe OPERATION_ID

Reemplaza OPERATION_ID por el ID de operación de la extensión de esquema. Por ejemplo, operation-1234567890-98765a1b2c3d4e5-e6f7g8-9h0i1j2

Verifica la extensión de esquema

Después de extender el esquema de tu instancia de Microsoft AD administrado, es importante que verifiques los cambios del esquema antes de integrar tus aplicaciones con Active Directory. Puedes verificar los cambios del esquema con diferentes herramientas y enfoques. En las siguientes secciones, explicamos cómo puedes verificar los cambios de esquema con cualquiera de estos enfoques:

  1. Complemento de esquema de Active Directory
  2. WindowsPowerShell

Complemento de esquema de Active Directory

Para verificar los cambios del esquema con el complemento de esquema de Active Directory, haz lo siguiente:

  1. Accede a la VM unida al dominio como administrador delegado.
  2. Instala el complemento de esquema de Active Directory.
  3. Abre la consola de administración de Microsoft (MMC).
  4. Expande el árbol del Esquema de Active Directory de tu directorio.
  5. Verifica si puedes ver los cambios en las clases y los atributos del esquema.

WindowsPowerShell

Para verificar los cambios del esquema con Windows PowerShell, usa elcmd Get-ADObject. Ejecuta el siguiente comando en Windows PowerShell:

get-adobject -Identity 'cn=ATTRIBUTE,cn=Schema,cn=Configuration,dc=ROOT_DOMAIN,dc=TOP_LEVEL_DOMAIN' -Properties *

Reemplaza lo siguiente:

  • ATTRIBUTE: Es el nombre de un atributo del esquema. Por ejemplo, example-attribute
  • ROOT_DOMAIN: El dominio raíz de tu nombre de dominio. Por ejemplo, si tu nombre de dominio es example.com, ingresa example.
  • TOP_LEVEL_DOMAIN: Es el dominio de nivel superior de tu nombre de dominio. Por ejemplo, si tu nombre de dominio es example.com, ingresa com.

En la respuesta, verifica si puedes ver los cambios en las clases y los atributos del esquema.

¿Qué sigue?