{"id":27,"date":"2020-10-16T02:30:44","date_gmt":"2020-10-16T02:30:44","guid":{"rendered":"https:\/\/tecno-experts.com\/fransilvablog\/?p=27"},"modified":"2020-10-16T02:30:44","modified_gmt":"2020-10-16T02:30:44","slug":"branding-tenant-vcloud-director-10-x","status":"publish","type":"post","link":"https:\/\/tecno-experts.com\/fransilvablog\/vmware-cloud-director\/branding-tenant-vcloud-director-10-x\/","title":{"rendered":"Branding tenant vCloud Director 10.x"},"content":{"rendered":"<p style=\"text-align: justify;\"><span style=\"font-size: 12pt;\">Hola, en este post vamos a realizar la customizaci\u00f3n de la p\u00e1gina de gesti\u00f3n de nuestros clientes IaaS, el m\u00e9todo para cambiar los colores, \u00edconos, nombres y links que vienen por defecto en la vista web puede ser\u00a0realizada\u00a0a trav\u00e9s de los APIs de VMware Cloud Director.<\/span><\/p>\n<p style=\"text-align: justify;\"><span style=\"font-size: 12pt;\">Para ingresar al explorador de APIs de VMware Cloud Director, debemos dirigirnos a la URL <a href=\"https:\/\/{ip_vCD}\/tenant\/{nombre_organizaci\u00f3n}\">https:\/\/{ip_vCD}\/tenant\/{nombre_organizaci\u00f3n}<\/a>\u00a0en donde podemos encontrar los OpenApi que est\u00e1n 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\u00f3n los comandos ReSTful que aceptan.<\/span><\/p>\n<p><img decoding=\"async\" src=\"https:\/\/tecno-experts.com\/fransilvablog\/wp-content\/uploads\/fransilvablog\/images\/articulos\/2021-03-01_02h22_23.png\" \/><\/p>\n<p style=\"text-align: justify;\"><span style=\"font-size: 14pt;\"><strong><span style=\"color: #0000ff;\">Conexi\u00f3n usando Postman:<\/span><\/strong><\/span><\/p>\n<p style=\"text-align: justify;\"><span style=\"font-size: 12pt;\">Para iniciar les aconsejo usar la herramienta\u00a0<a href=\"https:\/\/www.postman.com\/downloads\/\">Postman<\/a>. Primero instalamos la herramienta y apagamos la opci\u00f3n de\u00a0<em>\u201cSSH certificate Verification\u201d<\/em>\u00a0en configuraciones de Postman.<\/span><\/p>\n<p style=\"text-align: justify;\"><span style=\"font-size: 12pt;\">Una vez realizados estos pasos previos, vamos a realizar la conexi\u00f3n de vCD.\u00a0Colocamos las cabeceras del API de\u00a0vCD <em>\u00abapplication\/*+xml;version=34.0\u00bb<\/em>\u00a0y las credenciales de acceso, el tipo de autenticaci\u00f3n debe ser\u00a0<em>\u201cBasic Auth\u201d\u00a0<\/em> y ejecutamos un comando POST a la direcci\u00f3n URL <a href=\"https:\/\/{ip_vCD}\/api\/sessions\">https:\/\/{ip_vCD}\/api\/sessions<\/a>\u00a0para obtener nuestro token de conexi\u00f3n. Si desean pueden usar un token para automatizar esta configuraci\u00f3n, en el <a href=\"https:\/\/fojta.wordpress.com\/2018\/10\/18\/postman-and-vcloud-director-9-5-access-token-authentication\/\">blog de Tom Fojta<\/a> nos indica como.<\/span><\/p>\n<p style=\"text-align: justify;\"><span style=\"font-size: 12pt;\"><img decoding=\"async\" src=\"https:\/\/tecno-experts.com\/fransilvablog\/wp-content\/uploads\/fransilvablog\/images\/migrated-inline\/article-37-01.png\" \/><\/span><\/p>\n<p style=\"text-align: justify;\"><span style=\"font-size: 12pt;\"><img decoding=\"async\" src=\"https:\/\/tecno-experts.com\/fransilvablog\/wp-content\/uploads\/fransilvablog\/images\/migrated-inline\/article-37-02.png\" \/><\/span><\/p>\n<p style=\"text-align: justify;\"><span style=\"font-size: 12pt;\"><img decoding=\"async\" src=\"https:\/\/tecno-experts.com\/fransilvablog\/wp-content\/uploads\/fransilvablog\/images\/migrated-inline\/article-37-03.png\" \/><\/span><\/p>\n<p style=\"text-align: justify;\"><span style=\"font-size: 12pt;\">El c\u00f3digo que nos da, debe ser ingresado en las cabeceras para tener permisos y realizar los cambios que necesitamos. Comprobando r\u00e1pidamente que funciona se ejecuta un comando GET a una URL\u00a0<a href=\"https:\/\/{ip_vCD}\/api\/version\">https:\/\/{ip_vCD}\/api\/version<\/a>, si el resultado es el c\u00f3digo \u00ab200 OK\u00bb se puede continuar, caso contrario, debemos analizar si estamos colocando bien las cabeceras.<\/span><\/p>\n<p style=\"text-align: justify;\"><span style=\"font-size: 14pt; color: #0000ff;\"><strong>Configuraci\u00f3n de Branding<\/strong><\/span><\/p>\n<p style=\"text-align: justify;\"><span style=\"font-size: 12pt;\">Una vez hecha la conexi\u00f3n de Postman con los tokens de seguridad de vCD, podemos iniciar con las configuraciones a nuestro gusto. Pero primero hay que realizar una configuraci\u00f3n a la base de datos de vCD, usando el comando <strong>cell-management-tool<\/strong>, para permitir que el Branding de un tenant pueda ser visto en las p\u00e1ginas de inicio y cierre de sesi\u00f3n. Para m\u00e1s informaci\u00f3n <a href=\"https:\/\/docs.vmware.com\/en\/VMware-Cloud-Director\/10.0\/com.vmware.vcloud.spportal.doc\/GUID-CAD48B45-35DE-4E6F-BD8F-002238ED6B47.html\">Customizing the vCloud Director Portals<\/a>.<\/span><\/p>\n<pre class=\"language-markup\"><code>\/opt\/vmware\/vcloud-director\/bin\/cell-management-tool manage-config -n backend.branding.requireAuthForBranding -v false<\/code><\/pre>\n<p style=\"text-align: justify;\"><span style=\"font-size: 12pt;\"><img decoding=\"async\" src=\"https:\/\/tecno-experts.com\/fransilvablog\/wp-content\/uploads\/fransilvablog\/images\/migrated-inline\/article-37-04.png\" \/><\/span><\/p>\n<p style=\"text-align: justify;\"><span style=\"font-size: 12pt;\">Bien, iniciando con el proceso de branding, a continuaci\u00f3n coloco los par\u00e1metros de cabecera para cada uno de los APIs:<\/span><\/p>\n<pre class=\"language-markup\"><code>PUT \/cloudapi\/branding\/tenant\/{id_tenant}\r\n\r\nContent-Type: aplication\/json\r\n\r\nBody: \r\n{\r\n    \u201cportalName\u201d: \u201cFrancisco Silva\u201d,\r\n    \u201cportalColor\u201d: \u201c#C45D22\u201d,\r\n    \u201cselectedTheme\u201d: {\r\n        \u201cthemeType\u201d: \u201cBUILT_IN\u201d,\r\n        \u201cname\u201d: \u201cDark\u201d    },\r\n    \u201ccustomLinks\u201d: []\r\n}<\/code><\/pre>\n<pre class=\"language-markup\"><code>PUT \/cloudapi\/branding\/tenant\/{id_tenant}\/logo\r\n\r\nContent-Type: image\/png\r\n\r\nBody: &lt;binary image file&gt;<\/code><\/pre>\n<pre class=\"language-markup\"><code>PUT \/cloudapi\/branding\/tenant\/{id_tenant}\/icon\r\n\r\nContent-Type: image\/png\r\n\r\nBody: &lt;binary image file&gt;<\/code><\/pre>\n<p style=\"text-align: justify;\"><span style=\"font-size: 12pt;\">Donde:\u00a0<\/span><\/p>\n<p style=\"text-align: justify;\"><span style=\"font-size: 12pt;\">PortaName: nombre de la organizaci\u00f3n.<\/span><\/p>\n<p style=\"text-align: justify;\"><span style=\"font-size: 12pt;\">PortalColor: color de la organizaci\u00f3n.<\/span><\/p>\n<p style=\"text-align: justify;\"><span style=\"font-size: 12pt;\">ThemeType: tipo de tema XML.<\/span><\/p>\n<p style=\"text-align: justify;\"><span style=\"font-size: 12pt;\">binaryImageFile: Archivo de imagen tipo PNG para colocarlo como logo y como \u00edcono de pesta\u00f1a.<\/span><\/p>\n<p style=\"text-align: justify;\"><span style=\"font-size: 12pt;\"><img decoding=\"async\" src=\"https:\/\/tecno-experts.com\/fransilvablog\/wp-content\/uploads\/fransilvablog\/images\/migrated-inline\/article-37-05.png\" \/><\/span><\/p>\n<p style=\"text-align: justify;\"><span style=\"font-size: 14pt;\"><strong><span style=\"color: #0000ff;\">En conclusi\u00f3n.<\/span><\/strong><\/span><\/p>\n<p style=\"text-align: justify;\"><span style=\"font-size: 12pt;\">Se debe tener en cuenta que la p\u00e1gina de inicio de sesi\u00f3n del tenant va a pintarse del color que se configure, para cambiar esta p\u00e1gina y poner una customizada por la empresa que provee el servicio IaaS. Este proceso se hace a trav\u00e9s del API de Tema: branding\/tenant\/{id_tentant}\/theme.<\/span><\/p>\n<p style=\"text-align: justify;\"><span style=\"font-size: 12pt;\">Por defecto vCD tiene dos temas, uno en blanco y otro oscuro, puede ser cambiado si as\u00ed lo desean.<\/span><\/p>\n","protected":false},"excerpt":{"rendered":"<p>Hola, en este post vamos a realizar la customizaci\u00f3n de la p\u00e1gina de gesti\u00f3n de nuestros clientes IaaS, el m\u00e9todo para cambiar los colores, \u00edconos, nombres y links [&hellip;]<\/p>\n","protected":false},"author":1,"featured_media":28,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[3],"tags":[19,41,10,43,20,9,42,35,30],"class_list":["post-27","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-vmware-cloud-director","tag-apis","tag-branding","tag-cloud","tag-organizacion","tag-postman","tag-tecnologia","tag-tenant","tag-vcd10-2","tag-vmwareclouddirector"],"_links":{"self":[{"href":"https:\/\/tecno-experts.com\/fransilvablog\/wp-json\/wp\/v2\/posts\/27","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/tecno-experts.com\/fransilvablog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/tecno-experts.com\/fransilvablog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/tecno-experts.com\/fransilvablog\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/tecno-experts.com\/fransilvablog\/wp-json\/wp\/v2\/comments?post=27"}],"version-history":[{"count":0,"href":"https:\/\/tecno-experts.com\/fransilvablog\/wp-json\/wp\/v2\/posts\/27\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/tecno-experts.com\/fransilvablog\/wp-json\/wp\/v2\/media\/28"}],"wp:attachment":[{"href":"https:\/\/tecno-experts.com\/fransilvablog\/wp-json\/wp\/v2\/media?parent=27"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/tecno-experts.com\/fransilvablog\/wp-json\/wp\/v2\/categories?post=27"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/tecno-experts.com\/fransilvablog\/wp-json\/wp\/v2\/tags?post=27"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}