Implementazione di WS-Security
Configurare l'autenticazione, la crittografia XML, la firma XML e la scadenza del messaggio utilizzando l'editor di bind e serie di politiche WS.
Informazioni su questa attività
È possibile utilizzare l'editor dei set di criteri e dei collegamenti WS presente nel Toolkit " IBM® App Connect Enterprise " per configurare i seguenti aspetti di WS-Security:
IBM App Connect Enterprise offre il supporto per WS-Security sui server di integrazione configurati per l'utilizzo di Java 8. I server di integrazione su IBM App Connect Enterprise 13.0 utilizzano Java 17 per impostazione predefinita, ma è possibile configurarli per utilizzare Java 8 tramite il comando ibmint specify jre.
Autenticazione
Informazioni su questa attività
Sono supportati i seguenti token:
- Nome utente
- X.509
- Asserzioni SAML
- Ticket Kerberos
- Token binari LTPA
- Configurazione dell'autenticazione con i token Nome utente:
- Nel Toolkit di IBM App Connect Enterprise, creare un progetto di criteri facendo clic su File > Nuovo > Progetto di criteri.
- Nella vista Sviluppo applicazioni, fare clic con il pulsante destro del mouse sul progetto di criteri, quindi fare clic su Nuovo > Set di criteri WS e binding. Viene aperto l'Editor delle serie di politiche e dei bind WS.
- Fare clic su Aggiungi per creare una serie di politiche.
- Selezionare la nuova politica nella vista ad albero, quindi fare clic su Aggiungi WS - Security per aggiungere il tipo di politica alla serie di politiche.
- Espandere il tipo di criterio WS-Security nella struttura ad albero, fare clic su Token di autenticazione, quindi fare clic su Aggiungi per aggiungere i token di autenticazione UserName al criterio (vedere Editor set di criteri e binding set di criteri: pannello Token di autenticazione ).
- Ripetere il passaggio precedente per configurare i token di autenticazione X.509 (vedere l' editor Set di criteri e binding di set di criteri: Pannello Token di autenticazione e protezione ).
- Configurare un profilo di sicurezza (vedere Sicurezza del flusso di messaggi e profili di sicurezza ).
- Associare il set di criteri a un flusso di messaggi o a un nodo (vedere Associare set di criteri e vincoli a flussi di messaggi e nodi ).
- Configurazione dell'autenticazione con i token X.509:
- Se si sta utilizzando il truststore del nodo di integrazione per conservare il certificato attendibile, è necessario configurarlo. Vedere Visualizzazione e impostazione delle proprietà di keystore e truststore runtime a livello di nodo di integrazione o Visualizzazione e impostazione delle proprietà di keystore e truststore runtime a livello di server di integrazione, a seconda di dove si desidera impostare le proprietà di keystore e truststore runtime.
- Creare una serie di politiche (come descritto nella sezione precedente), quindi aggiungere UserName e token di autenticazione X.509 .
- Configurare la modalità di certificato per il truststore del nodo di integrazione o per un provider di sicurezza esterno (vedere l' editor Set di criteri e binding dei set di criteri: Pannello Token di autenticazione e protezione ).
- Se si utilizza un provider di sicurezza esterno, configurare un profilo di sicurezza (vedere Sicurezza del flusso di messaggi e profili di sicurezza ).
- Associare il set di criteri a un flusso di messaggi o a un nodo (vedere Associare set di criteri e vincoli a flussi di messaggi e nodi ).
- Configurazione dell'autenticazione con le asserzioni SAML:
- Creare un insieme di criteri e aggiungervi un token di pass-through SAML 1.1 o un token di pass-through SAML 2.0 (vedere l'editor "Insiemi di criteri e associazioni di insiemi di criteri": pannello "Token di autenticazione "). Il pass-through SAML non applica la conferma dell'oggetto, l'asserzione viene fornita semplicemente come token da elaborare nel server dei token di sicurezza esterno specificato nel profilo di sicurezza associato al nodo.
- Configurare un profilo di sicurezza. Il profilo di sicurezza deve essere configurato per utilizzare un STS WS-Trust v1.3 (vedere Sicurezza del flusso di messaggi e profili di sicurezza ).
- Associare il set di criteri a un flusso di messaggi o a un nodo (vedere Associare set di criteri e vincoli a flussi di messaggi e nodi ).
- Configurazione dell'autenticazione con i ticket Kerberos:
- Creare un set di criteri e aggiungere il tipo di token Kerberos come token simmetrico (vedere l' editor Set di criteri e binding dei set di criteri: Pannello Protezione a livello di messaggio ).
- Associare il set di criteri a un flusso di messaggi o a un nodo (vedere Associare set di criteri e binding a flussi di messaggi e nodi ).
- Configurare il file keytab Kerberos dell'host. Per ulteriori informazioni sulla configurazione di Kerberos , consultare la documentazione per il sistema host del proprio nodo di integrazione. Ad esempio, per Windows, consultare la guida "Step-by-Step Guide to Kerberos 5 (krb5 1.0) Interoperability", accessibile all'indirizzo http://technet.microsoft.com/en-us/library/.
- Configurazione dell'autenticazione con i token binari LTPA:
- Creare un set di criteri e aggiungervi i token LTPA (vedere Editor dei set di criteri e dei binding dei set di criteri: pannello dei token di autenticazione ). Il token binario LTPA viene trasmesso all'STS (Security Token Service) esterno specificato nel profilo di sicurezza associato con il nodo.
- Configurare un profilo di sicurezza. Il profilo di sicurezza deve essere configurato per utilizzare un STS WS-Trust v1.3 (vedere Sicurezza del flusso di messaggi e profili di sicurezza ).
- Associare il set di criteri a un flusso di messaggi o a un nodo (vedere Associare set di criteri e binding a flussi di messaggi e nodi ).
Riservatezza
Informazioni su questa attività
La riservatezza è fornita dalla codifica XML e richiede i token X.509 o i ticket Kerberos.
- Configurazione della codifica XML con token X.509:
- Se si sta utilizzando il truststore del nodo di integrazione per conservare il certificato attendibile, è necessario configurarlo. Vedere Visualizzazione e impostazione delle proprietà di keystore e truststore runtime a livello di nodo di integrazione o Visualizzazione e impostazione delle proprietà di keystore e truststore runtime a livello di server di integrazione, a seconda di dove si desidera impostare le proprietà di keystore e truststore runtime.
- Creare un set di criteri, abilitare la crittografia XML, creare token di crittografia e selezionare gli algoritmi di crittografia da utilizzare (vedere l' editor Set di criteri e binding dei set di criteri: Pannello Protezione a livello di messaggio ).
- Definire quali parti di un messaggio devono essere crittografate (vedere l' editor Set di criteri e binding di set di criteri: Pannello Protezione parti del messaggio ).
- Configurare ulteriormente la crittografia della parte di messaggio (vedere l' editor dei set di criteri e dei binding dei set di criteri: pannello Criteri della parte di messaggio ).
- Configurare ulteriormente il keystore e il truststore (vedere Editor dei set di criteri e dei binding dei set di criteri: pannello Informazioni sulla chiave ).
- Associare il set di criteri a un flusso di messaggi o a un nodo (vedere Associare set di criteri e binding a flussi di messaggi e nodi ).
- Configurazione della codifica XML con i ticket Kerberos:
- Configurare l'host per Kerberos, fornendo un file di configurazione krb.conf. Questo passaggio è necessario in tutti i sistemi operativi, incluso Windows.
- Fornire il nodo di integrazione con le credenziali client Kerberos per accedere a KDC (Key Distribution Center) Kerberos . Queste credenziali (richieste per i nodi SOAPRequest ) possono essere fornite nella struttura ad albero delle proprietà del nodo di integrazione o utilizzando il comando mqsisetdbparms . Le
credenziali vengono acquisite in ordine di priorità:
- Il nodo ha un profilo di sicurezza con la proprietà propagazione impostata su True ed è presente il token Nome utente e password della struttura ad albero delle proprietà. Se non esiste alcun token Nome utente e password, viene generata un'eccezione.
mqsisetdbparms kerberos::<realm>::<integrationServerName>mqsisetdbparms kerberos::<realm>mqsisetdbparms kerberos::kerberos
- Creare un set di criteri e aggiungere il tipo di token Kerberos richiesto come Token simmetrico (vedere l' editor Set di criteri e binding dei set di criteri: Pannello Protezione a livello di messaggio ).
Integrità
Informazioni su questa attività
L'integrità viene fornita dalla firma XML e richiede token X.509 o ticket Kerberos.
- Configurazione della firma XML con token X.509:
- Se si sta utilizzando il truststore del nodo di integrazione per conservare il certificato attendibile, è necessario configurarlo. Vedere Visualizzazione e impostazione delle proprietà di keystore e truststore runtime a livello di nodo di integrazione o Visualizzazione e impostazione delle proprietà di keystore e truststore runtime a livello di server di integrazione, a seconda di dove si desidera impostare le proprietà di keystore e truststore runtime.
- Creare un set di criteri, attivare la firma XML e creare token di firma (vedere l' editor Set di criteri e binding di set di criteri: Pannello Protezione a livello di messaggio ).
- Definire quali parti di un messaggio devono essere firmate (vedere l' editor Set di criteri e binding di set di criteri: Pannello Protezione delle parti del messaggio ).
- Configurare ulteriormente la firma della parte di messaggio (vedere l' editor dei set di criteri e dei binding dei set di criteri: pannello Criteri della parte di messaggio ).
- Configurare ulteriormente il keystore e il truststore (vedere Editor dei set di criteri e dei binding dei set di criteri: pannello Informazioni sulla chiave ).
- Associare il set di criteri a un flusso di messaggi o a un nodo (vedere Associare set di criteri e vincoli a flussi di messaggi e nodi ).
- Configurazione della firma XML con i ticket Kerberos:
- Configurare l'host per Kerberos, fornendo un file di configurazione krb.conf. Questo passaggio è necessario in tutti i sistemi operativi, incluso Windows.
- Fornire il nodo di integrazione con le credenziali client Kerberos per accedere a KDC (Key Distribution Center) Kerberos . Queste credenziali (richieste per i nodi SOAPRequest ) possono essere fornite nella struttura ad albero delle proprietà del nodo di integrazione o utilizzando il comando mqsisetdbparms . Le
credenziali vengono acquisite nel seguente ordine di priorità:
- Il nodo ha un profilo di sicurezza con la proprietà propagazione impostata su True ed è presente il token Nome utente e password della struttura ad albero delle proprietà. Se non esiste alcun token Nome utente e password, viene generata un'eccezione.
mqsisetdbparms kerberos::<realm>::<integrationServerName>mqsisetdbparms kerberos::<realm>mqsisetdbparms kerberos::kerberos
- Creare un set di criteri e aggiungere il tipo di token Kerberos richiesto come Token simmetrico (vedere l' editor Set di criteri e binding dei set di criteri: Pannello Protezione a livello di messaggio ).
Scadenza
Procedura
Per configurare la scadenza dei messaggi, vedere Editor dei set di criteri e dei binding dei set di criteri: Pannello Scadenza messaggi.