Intégration du magasin de certificats avec MicroStrategy Library

Certificate Store sert principalement de source de données exposée via une API REST. Cette source de données fournit les données à afficher dans la section Certificats de la fenêtre Poste de travail.

Intégration avec MicroStrategy Library

Pour intégrer le magasin de certificats à MicroStrategy Library, vous pouvez sélectionner le magasin de certificats lors de l'installation de Library. Cela garantira que l'API REST du magasin de certificats semble faire partie de l'ensemble de la suite d'API REST de MicroStrategy.

Ainsi, même s'il semble que l'API REST du magasin de certificats (/api/serviceCertificates ) est servie à partir du même point de terminaison Web que les autres API, dans la réalité les requêtes faites à /api/serviceCertificates Le point de terminaison est en fait redirigé vers le serveur du magasin de certificats. Cette redirection est effectuée par un servlet proxy configuré dans le fichier Library web.xml.

Le servlet est configuré par le programme d'installation, prend toutes les URL qui correspondent à la propriété de modèle d'url et les redirige vers l'URL spécifiée dans Uri cible propriété. Si vous modifiez ces paramètres pour ajouter ou supprimer la prise en charge SSL, vous devez mettre à jour Uri cible pour indiquer soit « http », soit « https ».

Si des certificats auto-signés sont utilisés, les propriétés trustAllCertificates et désactiverHostnameVerification doivent être définies sur vrai. Si un utilisateur bascule entre des certificats auto-signés et affectés par une autorité de certification, il doit définir les deux certificats comme faux pour bénéficier des avantages du cert.

<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>

Où :

• chemin du magasin de confiance est utilisé pour charger le magasin de confiance qui est géré par ServletContext.getResourceAsStream().  

  Les règles de chemin d'accès pour cette méthode peuvent être trouvées dans la Documentation Oracle. Le chemin doit commencer par une barre oblique (/ ) et est interprété comme relatif à la racine de contexte actuelle ou par rapport à la /META-INF/ressources répertoire d'un fichier JAR dans l'application Web /WEB-INF/lib répertoire. Le séparateur de chemin est une barre oblique (/ ) sous Unix et Windows.

• type de magasin de confiance accepte divers types de magasins de clés/de confiance, pour une liste complète, consultez la Documentation Java SE. MicroStrategy prend en charge JKS et PKCS12.

Propriétés de configuration du magasin de certificats

Les paramètres du magasin de certificats peuvent être modifiés en modifiant le application.propriétés fichier. Tous les paramètres sont sensibles à la casse et doivent être saisis correctement pour que les modifications prennent effet.

Le application.propriétés peut être trouvé dans :

• Windows : < INSTALL_PATH> \MicroStrategy\Certificate Manager
• Linux : < INSTALL_PATH> /Gestionnaire de certificats

Ce fichier inclut les propriétés suivantes :

Considérations dans les environnements clusterisés

Le processus Certificate Store écoute normalement les requêtes API REST sur localhost:5050. Le serveur est lié à l'interface de bouclage afin que seuls les processus sur la même machine puissent effectuer des requêtes API.

Dans un environnement en cluster, il existe un processus de magasin de certificats sur chaque nœud. Étant donné que Certificate Store construit ses données à partir des services enregistrés auprès de Consul et que Consul contient des entrées pour tous les nœuds, Certificate Store contiendra des entrées pour tous les services du cluster et non pour les services du nœud actuel. Toutefois, étant donné que certains services sont liés à l'adresse de bouclage, certains certificats ne pourront pas être récupérés à partir d'autres nœuds du cluster.

Autres considérations Library

Si votre installation Library ne dispose pas d'un magasin de certificats, le servlet proxy peut toujours être configuré, mais la Uri cible ne pointera pas vers un point de terminaison valide. Les utilisateurs avec cette configuration recevront une erreur 502 Bad Gateway (ou d'autres erreurs HTTP de niveau 5xx). Pour résoudre ces erreurs, vous pouvez installer le magasin de certificats ou supprimer la configuration du servlet proxy du fichier Library web.xml.