Integrazione dell'archivio certificati con MicroStrategy Library

L'archivio certificati funge principalmente da origine dati esposta tramite un'API REST. Questa origine dati fornisce i dati da visualizzare nella sezione Certificati della finestra Workstation.

Integrazione con MicroStrategy Library

Per integrare Archivio certificati con MicroStrategy Library, è possibile selezionare Archivio certificati durante l'installazione di Library. In questo modo si farà in modo che l'API REST dell'archivio certificati appaia come parte dell'intera suite di API REST di MicroStrategy.

Quindi, anche se sembra che l'API REST dell'archivio certificati (/api/serviceCertificates ) è servito dallo stesso endpoint Web delle altre API, in realtà richieste rivolte a /api/serviceCertificates endpoint vengono effettivamente reindirizzati al server archivio certificati. Questo reindirizzamento viene eseguito da un servlet proxy configurato nel file web.xml di Library.

Il servlet viene configurato dal programma di installazione, accetta tutti gli URL che corrispondono alla proprietà url-pattern e li reindirizza all'URL specificato nella targetUri proprietà. Se si stanno modificando queste impostazioni per aggiungere o rimuovere il supporto SSL, è necessario aggiornare il targetUri in modo da specificare "http" o "https".

Se vengono utilizzati certificati autofirmati, le proprietà trustAllCertificates e disableHostnameVerification devono essere impostate su vero. Se un utente passa dai certificati autofirmati a quelli assegnati da un'autorità di certificazione, è necessario impostare entrambi i certificati su falso di ricevere i vantaggi della certificazione assegnata dalla 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>

Dove:

• truststorePath viene utilizzato per caricare il truststore gestito da ServletContext.getResourceAsStream().  

  Le regole del percorso per questo metodo sono disponibili in Documentazione Oracle. Il percorso deve iniziare con una barra (/ ) e viene interpretato come relativo alla radice del contesto corrente o relativo a /META-INF/risorse directory di un file JAR all'interno della directory / dell'applicazione WebWEB-INF/lib directory. Il separatore di percorso è una barra (/ ) sia in Unix che in Windows.

• truststoreType accetta diversi tipi di keystore/truststore; per un elenco completo, vedere Documentazione Java SE. MicroStrategy supporta JKS e PKCS12.

Proprietà di configurazione dell'archivio certificati

Le impostazioni per l'archivio certificati possono essere modificate modificando il file proprietà.applicazione file. Tutti i parametri fanno distinzione tra maiuscole e minuscole e devono essere immessi correttamente affinché le modifiche abbiano effetto.

Il proprietà.applicazione può essere trovato in:

• Windows: < PERCORSO_INSTALLAZIONE> \MicroStrategy\Gestione certificati
• Linux: < PERCORSO_INSTALLAZIONE> /Gestione certificati

Questo file include le seguenti proprietà:

Considerazioni sugli ambienti cluster

Il processo di archiviazione certificati normalmente ascolta le richieste API REST su localhost:5050. Il server è legato all'interfaccia di loopback in modo che solo i processi sulla stessa macchina possano effettuare richieste API.

In un ambiente cluster, è presente un processo di archiviazione certificati su ciascun nodo. Poiché Archivio certificati crea i propri dati dai servizi registrati con Consul e Console contiene voci per tutti i nodi, Archivio certificati conterrà voci per tutti i servizi nel cluster e non per i servizi sul nodo corrente. Tuttavia, poiché alcuni servizi sono associati all'indirizzo di loopback, alcuni certificati non potranno essere recuperati da altri nodi del cluster.

Altre considerazioni su Library

Se l'installazione di Library non dispone di un archivio certificati, è possibile che il servlet proxy sia ancora configurato, ma l'estensione targetUri non punterà a un endpoint valido. Gli utenti con questa configurazione riceveranno un errore 502 Bad Gateway (o altri errori HTTP di livello 5xx). Per risolvere questi errori, è possibile installare l'archivio certificati o rimuovere la configurazione del servlet proxy dal file web.xml di Library.