Integración del almacén de certificados con MicroStrategy Library

El almacén de certificados sirve principalmente como fuente de datos expuesta a través de una API REST. Esta fuente de datos proporciona los datos que se mostrarán en la sección Certificados de la ventana Estación de trabajo.

Integración con MicroStrategy Library

Para integrar el Almacén de certificados con MicroStrategy Library, puede seleccionar Almacén de certificados al instalar Library. Esto garantizará que la API de REST del almacén de certificados aparece como parte del conjunto completo de API de REST de MicroStrategy.

Por lo tanto, aunque parece que la API de REST del almacén de certificados (/api/serviceCertificates ) es atendida desde el mismo punto de conexión web que las demás API, en realidad solicitudes realizadas a la /api/serviceCertificates de conexión se redirigen en realidad al servidor de almacén de certificados. Esta redirección la realiza un servlet de proxy configurado en el archivo web.xml de Library.

El instalador ha configurado el servlet y toma todos los URL que coinciden con la propiedad de patrón-de-url y los redirige al URL especificado en el targetUri propiedad. Si está modificando esta configuración para añadir o quitar compatibilidad con SSL, debe actualizar el targetUri de modo que especifique "http" o "https".

Si se utilizan certificados autofirmados, las propiedades trustAllCertificates y disabledHostnameVerification deben establecerse en verdadero. Si un usuario cambia de certificados autofirmados a certificados asignados por una CA, debe establecer ambos certificados en false para beneficiarse del certificado asignado por la CA.

<servlet>
<servlet-name>CertificateManagerService</servlet-name>
<servlet-class>org.mitre.dsmiley.httpproxy.ProxyServlet</servlet-class>
<init-param>
<param-name>targetUri</param-name>
<param-value>http://localhost:5050/api/serviceCertificates</param-value>
</init-param>
<init-param>
<param-name>log</param-name>
<param-value>true</param-value>
</init-param>
<!-- SSL SUPPORT START - The following group of parameters are only relevant when the targetUri above uses the "https" protocol. -->
<init-param>
<param-name>truststorePath</param-name>
<param-value>{PATH_TO_TRUSTSTORE}</param-value>
</init-param>
<init-param>
<param-name>truststoreType</param-name>
<param-value>PKCS12</param-value>
</init-param>
<init-param>
<param-name>truststorePassword</param-name>
<param-value>{TRUSTSTORE_PASSWORD_OR_BLANK_IF_NONE}</param-value>
</init-param>
<init-param>
<param-name>keyPassword</param-name>
<param-value>{KEY_PASSWORD_OR_BLANK_IF_NONE}</param-value>
</init-param>
<!-- DEVELOPMENT - START - The following parameters are for development/debugging use only and should not be set to TRUE in production systems. -->
<init-param>
<param-name>trustAllCertificates</param-name>
<param-value>false</param-value>
</init-param>
<init-param>
<param-name>disableHostnameVerification</param-name>
<param-value>false</param-value>
</init-param>
<!-- DEVELOPMENT END -->
<!-- SSL SUPPORT END -->
</servlet>
<servlet-mapping>
<servlet-name>CertificateManagerService</servlet-name>
<url-pattern>/api/serviceCertificates/*</url-pattern>
</servlet-mapping>

Donde:

• truststorePath se utiliza para cargar el truststore, que está a cargo de ServletContext.getResourceAsStream().  

  Las reglas de ruta de acceso de este método se incluyen en el archivo Documentación de Oracle. La ruta debe comenzar con una barra inclinada (/ ) y se interpreta como relativo a la raíz de contexto actual o relativo a la /META-INF/resources de un archivo JAR dentro del directorio / de la aplicación webWEB-INF/lib directorio. El separador de ruta es una barra inclinada (/ ) en Unix y Windows.

• truststoreType acepta distintos tipos de almacén de claves/almacén de confianza; para obtener una lista completa, consulte el Documentación de Java SE. MicroStrategy es compatible con JKS y PKCS12.

Propiedades de configuración del almacén de certificados

La configuración del almacén de certificados se puede cambiar editando el application.properties archivo. Todos los parámetros distinguen entre mayúsculas y minúsculas y deben ingresarse correctamente para que los cambios surtan efecto.

El application.properties se puede encontrar en:

• Ventanas: < INSTALL_PATH> \MicroStrategy\Certificate Manager
• Linux: < INSTALL_PATH> /Administrador de certificados

Este archivo incluye las siguientes propiedades:

Consideraciones en entornos agrupados

El proceso del almacén de certificados normalmente escucha las solicitudes de API REST en localhost:5050. El servidor está vinculado a la interfaz loopback para que solo los procesos en la misma máquina puedan realizar solicitudes API.

En un entorno agrupado, hay un proceso de almacén de certificados en cada nodo. Debido a que el Almacén de certificados genera sus datos a partir de los servicios registrados con Consul, y Consul contiene entradas para todos los nodos, el Almacén de certificados contendrá entradas para todos los servicios en el clúster y no aquellos servicios en el nodo actual. Sin embargo, debido a que algunos servicios están vinculados a la dirección de bucle invertido, algunos certificados no se podrán recuperar de otros nodos del clúster.

Otras consideraciones sobre Library

Si su instalación de Library no tiene almacén de certificados, es posible que el servlet del proxy aún esté configurado; sin embargo, la targetUri no apuntará a un punto de conexión válido. Los usuarios con esta configuración recibirán un error 502 Bad Gateway (u otros errores HTTP de nivel 5xx). Para resolver estos errores, puede instalar el Almacén de certificados o eliminar la configuración del servlet del proxy del archivo web.xml de Library.