Branding tenant vCloud Director 10.x
Hola, en este post vamos a realizar la customización de la página de gestión de nuestros clientes IaaS, el método para cambiar los colores, íconos, nombres y links que vienen por defecto en la vista web puede ser realizada a través de los APIs de VMware Cloud Director.
Para ingresar al explorador de APIs de VMware Cloud Director, debemos dirigirnos a la URL https://{ip_vCD}/tenant/{nombre_organización} en donde podemos encontrar los OpenApi que están disponibles y pueden ser usados para sus fines pertinentes, en nuestro caso los APIs que vamos a usar son los de BRANDING y a continuación los comandos ReSTful que aceptan.
Conexión usando Postman:
Para iniciar les aconsejo usar la herramienta Postman. Primero instalamos la herramienta y apagamos la opción de “SSH certificate Verification” en configuraciones de Postman.
Una vez realizados estos pasos previos, vamos a realizar la conexión de vCD. Colocamos las cabeceras del API de vCD "application/*+xml;version=34.0" y las credenciales de acceso, el tipo de autenticación debe ser “Basic Auth” y ejecutamos un comando POST a la dirección URL https://{ip_vCD}/api/sessions para obtener nuestro token de conexión. Si desean pueden usar un token para automatizar esta configuración, en el blog de Tom Fojta nos indica como.
El código que nos da, debe ser ingresado en las cabeceras para tener permisos y realizar los cambios que necesitamos. Comprobando rápidamente que funciona se ejecuta un comando GET a una URL https://{ip_vCD}/api/version, si el resultado es el código "200 OK" se puede continuar, caso contrario, debemos analizar si estamos colocando bien las cabeceras.
Configuración de Branding
Una vez hecha la conexión de Postman con los tokens de seguridad de vCD, podemos iniciar con las configuraciones a nuestro gusto. Pero primero hay que realizar una configuración a la base de datos de vCD, usando el comando cell-management-tool, para permitir que el Branding de un tenant pueda ser visto en las páginas de inicio y cierre de sesión. Para más información Customizing the vCloud Director Portals.
/opt/vmware/vcloud-director/bin/cell-management-tool manage-config -n backend.branding.requireAuthForBranding -v false
Bien, iniciando con el proceso de branding, a continuación coloco los parámetros de cabecera para cada uno de los APIs:
PUT /cloudapi/branding/tenant/{id_tenant}
Content-Type: aplication/json
Body:
{
“portalName”: “Francisco Silva”,
“portalColor”: “#C45D22”,
“selectedTheme”: {
“themeType”: “BUILT_IN”,
“name”: “Dark” },
“customLinks”: []
}PUT /cloudapi/branding/tenant/{id_tenant}/logo
Content-Type: image/png
Body: <binary image file>PUT /cloudapi/branding/tenant/{id_tenant}/icon
Content-Type: image/png
Body: <binary image file>Donde:
PortaName: nombre de la organización.
PortalColor: color de la organización.
ThemeType: tipo de tema XML.
binaryImageFile: Archivo de imagen tipo PNG para colocarlo como logo y como ícono de pestaña.
En conclusión.
Se debe tener en cuenta que la página de inicio de sesión del tenant va a pintarse del color que se configure, para cambiar esta página y poner una customizada por la empresa que provee el servicio IaaS. Este proceso se hace a través del API de Tema: branding/tenant/{id_tentant}/theme.
Por defecto vCD tiene dos temas, uno en blanco y otro oscuro, puede ser cambiado si así lo desean.
Tags: Tecnología, Cloud, VMwareCloudDirector, vCD10.2, apis, postman, branding, tenant, organizacion