Tipi di credenziale
Cosa contiene ogni tipo, e dove si può scegliere
I tipi
Il tipo dice a cosa serve una credenziale. Decide quali campi chiede la finestra di dialogo, e dove si può scegliere:
| Tipo | Cosa contiene | Usato da |
|---|---|---|
| Utente e password | Un utente e una password per qualsiasi accesso: una API REST con basic auth, un servizio e altro. Il predefinito | Playbook, tramite le credentials di un modulo o un campo credenziale; espressioni REST |
| SSH | Un utente e una password per SSH verso un server, con il suo host e la sua porta | Playbook, tramite le credentials di un modulo, ansibleCredentials o un campo credenziale, e l’accesso di un nodo di workflow |
| Git | Un utente e una password o un token per repository git | Repository |
| API | Un utente e una password o un token per una API REST | Espressioni REST, il token di un bot Telegram, il bearer token di un webhook, la chiave API dell’assistente chat |
| Database | Un accesso a un database, con il suo tipo, host, porta e nome del database | Un database che i moduli interrogano (dbConfig), dalla 7.5.0, o direttamente il dbConfig di un modulo; fnCredentials; si può testare |
| CyberArk | L’indirizzo del CyberArk Central Credential Provider (CCP) e il suo TLS, e l’AppID, il certificato client e la chiave con cui accede un archivio CyberArk | Un archivio di segreti CyberArk |
| SMTP | Un server mail, la sua porta e il TLS, e il suo accesso (nessuno per un relay) | Un canale di notifica mail |
| LDAP | I server di una directory, la porta, il TLS e i certificati, e il suo bind DN e la password | Una directory LDAP |
| Microsoft Entra ID | La registrazione dell’app di un provider: il tenant ID, il client ID, il client secret e l’URI di reindirizzamento | Un provider Entra ID |
| Open ID | Il client di un provider: l’issuer, il client ID, il client secret e l’URI di reindirizzamento | Un provider OIDC |
| RTE | Il token (RTE_TOKEN) e l’indirizzo di un RTE | Un runner RTE |
| AWX, AAP, Ascender | Il token o l’accesso, e l’indirizzo, di quella piattaforma | Un runner di quel tipo |
| Semaphore, Rundeck | Il token API e l’indirizzo di quel prodotto | Un runner di quel tipo |
| Jenkins | Un utente, il suo token API e l’indirizzo di un Jenkins | Un runner Jenkins |
| HashiCorp Vault | Il token e l’indirizzo con cui accede un archivio Vault | Un archivio di segreti HashiCorp Vault |
Una credenziale database può essere di tipo MySQL, MSSQL, PostgreSQL, Oracle o MongoDB. Dalla 7.5.0 viene scelta da un database di Connessioni > Database, e l’aggiornamento alla 7.5.0 crea un database per ognuna, con lo stesso nome.
Nell’API e nel config seed, i tipi sono userpass, ssh, git, api, database, cyberark, smtp, ldap, entraid, oidc, rte, awx, aap, ascender, semaphore, rundeck, jenkins e vault. L’aggiornamento dalla 6 assegna a ogni credenziale il tipo userpass, o database a una credenziale di database: un modulo la usa come nella 6. Cambiala in SSH per un accesso con cui si connette il playbook di un nodo di workflow, o in API per una API REST.
Indirizzi nelle credenziali
Dalla 7.3.0 un accesso che funziona su un server porta con sé quel server, così il record che lo usa indica solo la credenziale:
| Record | Cosa è passato nella sua credenziale |
|---|---|
| Una directory LDAP | I suoi server, la porta, il TLS, i certificati e l’account di bind, in una credenziale ldap chiamata <directory>-ldap |
| Un provider SSO | Il suo client ID e secret, il tenant o l’issuer, e l’URI di reindirizzamento, in una credenziale entraid o oidc chiamata <provider>-sso |
| Un runner | Il suo indirizzo e il TLS, e il suo token o accesso, in una credenziale del suo tipo, <runner>-token o <runner>-login |
| Un archivio di segreti | Il suo indirizzo e il TLS, e il suo token (<store>-token) o l’AppID e il certificato CyberArk (<store>-appid) |
| Un canale mail | Il suo server, la porta e il TLS, nella sua credenziale smtp, o in una nuova chiamata <channel>-smtp |
L’aggiornamento alla 7.3.0 fa questi spostamenti una sola volta. Un record che indicava già una credenziale la mantiene, e ne riceve una copia quando un altro record usava lo stesso accesso con un altro server. I record dichiarati nel config seed restano come li ha il seed. Le credenziali delle connessioni e degli accessi possono essere modificate solo da un admin, vedi Chi può modificare una credenziale.