Per risolvere questo avviso di validazione del certificato, prendere in considerazione le istruzioni riportate di seguito:

Utilizzo corretto:

Se si dispone del certificato su disco in una posizione qualsiasi, istanziare ISAMAppliance con:

È possibile recuperarlo dall'appliance utilizzando un comando come:

Se il certificato è già considerato attendibile nell'ambiente Python, istanziare ISAMAppliance con:

oppure impostare la variabile d'ambiente: IBMSECLIB_VERIFY_CONNECTION=true

Se si ricevono errori relativi al nome host che non corrisponde al certificato:

Potrebbe apparire così:

Assicurarsi che il nome host utilizzato durante l'istanziazione di ISAMAppliance corrisponda al Subject Alternative Name del certificato.

Verificare con:

Esempio:

Certificate:

…

Quanto segue genererà errori:

poiché il nome host non corrisponde al Subject Alternative Name. In alternativa, utilizzare:

Versionamento

Questo pacchetto utilizza una data per il versionamento. Ad esempio: "2017.03.18.0"

Si tratta della data in cui il pacchetto viene rilasciato, con un numero di sequenza alla fine per gestire i casi in cui vi siano più rilasci nello stesso giorno (cosa che dovrebbe essere rara).

Funzionalità

Questo pacchetto Python offre le seguenti funzionalità:

1. Facile da usare - i dettagli dell'esecuzione di una chiamata REST sono gestiti all'interno di una classe dell'appliance
2. Struttura intuitiva del pacchetto di codice e nomi che corrispondono all'interfaccia GUI dell'appliance
3. Idempotenza - le funzioni che effettuano aggiornamenti interrogano l'appliance per confrontare i dati forniti e verificare se una modifica è necessaria prima di apportare la modifica effettiva.
4. I passaggi Commit e Deploy sono forniti separatamente per consentire flessibilità nella loro invocazione
5. È incluso il logging standard - con la possibilità di impostare i livelli di logging.
6. I parametri delle funzioni utilizzeranno valori predefiniti standard dove possibile.
7. È prevista un'opzione force per ignorare l'idempotenza.
8. Sono fornite funzioni di confronto - accettano output JSON e forniscono un confronto significativo.

Formato dei dati restituiti dalle funzioni

Nota: è preferibile restituire avvisi piuttosto che un rc diverso da zero.

Organizzazione del codice

Classi degli appliance

Una classe astratta ibmappliance viene estesa per creare una classe per ciascun appliance supportato in questo repository. Attualmente si tratta degli appliance ISAM e ISDS.

Classi utente

Una classe astratta User viene estesa per ogni tipo di utente necessario. Per ISAM si tratta di un utente per l'accesso all'appliance e di un altro per l'autenticazione a Web Runtime (Policy Server).

Struttura dei pacchetti ISAM

Ci sono quattro pacchetti ISAM primari: base, web, aac e fed. web contiene tutti i componenti necessari per configurare le funzionalità web, inclusi ldap integrato, runtime e funzionalità attivate come parte del modulo wga. aac contiene le funzionalità attivate come parte del modulo mga e fed quelle della federation. base contiene tutto il resto - inclusi runtime di aac e fed e Audit Configuration (questi sono comuni a aac e fed e quindi si trovano in base).

Nomi di pacchetti e file

I nomi dei pacchetti e dei file sono stati creati con la seguente intenzione:

1. Mantenere nomi che corrispondano a quelli presenti nell'interfaccia GUI (LMI per l'appliance ISAM).
2. Ogni file dovrebbe contenere un solo tipo di funzione per ciascuna tipologia (vedere elenco sotto) - ad esempio un solo add().
3. Raggruppare funzioni correlate - una per ciascun tipo - in un file.
4. L'URI per le chiamate API REST all'interno di un file sarà lo stesso e gestirà una "funzionalità" dell'appliance.

Utility

Contiene funzioni varie generiche e indipendenti da qualsiasi appliance IBM, ad esempio json_compare().

Tipi di funzioni

get_all()

Questa funzione in genere restituisce tutti gli oggetti correlati a quella funzionalità.

get()

Questa funzione restituisce i dettagli di un particolare oggetto.

set()

Questa funzione determina se l'oggetto da manipolare esiste; in caso contrario chiama add(), altrimenti chiama update(). Nei casi in cui non esiste update(), confronta il valore esistente sull'appliance con quello impostato tramite la funzione - se diverso, elimina (delete()) l'oggetto prima di chiamare add().

add()

Controlla se l'oggetto esiste già - in tal caso lo salta, altrimenti lo aggiunge.

update()

Controlla se l'oggetto esiste già - in tal caso verifica se è necessario un aggiornamento prima di apportare una modifica, altrimenti non fa nulla.

delete()

Controlla se l'oggetto esiste già - in tal caso lo elimina, altrimenti non fa nulla.

import_<>()

"import" è una parola riservata, quindi viene aggiunto un suffisso per indicare cosa importare (ad esempio file o key). Questa funzione verifica se l'oggetto esiste prima di importarlo.

export_<>()

Export verifica se l'oggetto esiste prima di esportarlo - quando si esporta in un file e il file esiste già, non lo riesporta. Esporta

compare()

Compare accetta l'output JSON delle funzioni get_all() e lo confronta. Rimuove dall'JSON i dati che sono unici per ciascun appliance (ad esempio i valori UUID). Il valore deleted_keys restituito elenca le chiavi JSON che sono state eliminate prima del confronto.

Parametri delle funzioni

Oggetto Appliance

Creare un oggetto appliance e passarlo alla funzione. L'appliance e l'oggetto User necessari sono classi che consentono future estensioni come l'autenticazione tramite certificato anziché nome utente/password.

check_mode

Il valore predefinito è False; passare True per restituire senza apportare modifiche. Il flag "changed" verrà impostato su True se vengono rilevate modifiche.

force

Il valore predefinito è False; passare True per ignorare la logica di idempotenza.

Altri parametri

Gli altri parametri corrisponderanno esattamente alla documentazione dell'API REST. L'intenzione era quella di fare riferimento alla documentazione dell'API REST senza doverla ripetere. Fare riferimento alla documentazione dell'API REST per i dettagli.

Aggiunta e apportamento di modifiche

Si prega di aprire una issue su GitHub quando viene scoperto un bug o quando ci sono API REST non coperte da questo pacchetto. Fornire note dettagliate insieme ai log di traccia quando si segnala un bug.

Licenza

I contenuti di questo repository sono open-source secondo la licenza Apache 2.0.