Ottenere le stringhe di connessione

Il servizio IBM Cloud® Databases for Redis è stato fornito con l'autenticazione abilitata. Hai bisogno di un nome utente, una parola d'ordine e delle stringhe di connessione per connettersi e immettere i comandi.

Le stringhe di connessione per l'installazione sono visualizzate nella pagina Panoramica, nel pannello Endpoint. Tutti gli utenti nella tua distribuzione possono utilizzare le stringhe di connessione, incluse le stringhe di connessione per endpoint pubblici o privati.

La stringa di connessione verrà impostata per default sul database 0. Tuttavia, è supportata la modifica della connessione per connettersi a un database diverso da 0.

La distribuzione Redis viene fornita con un utente amministratore. È necessario impostare la password amministratore prima di poterla utilizzare per connettersi al database. Per ulteriori informazioni, consultare la pagina Impostazione della password amministratore.

Ottenere le stringhe di connessione dall'interfaccia utente

Seguire questi passaggi per recuperare le stringhe di connessione dell'istanza Databases for Redis:

Nella pagina Panoramica dell'installazione client, scorrere fino alla sezione Endpoint.
Nella sezione Endpoints è presente una scheda Quick start con le seguenti sezioni:
- Connettersi tramite CLI- Questa sezione contiene informazioni per connettersi all'installazione client tramite IBM CLI.
- Connettersi con un client Redis- Questa sezione consente di ottenere un certificato TLS e di connettersi all'installazione.

Ottenere le stringhe di connessione dalla CLI

Puoi acquisire le stringhe di connessione dalla CLI.

ibmcloud cdb deployment-connections <INSTANCE_NAME_OR_CRN> -u <NEWUSERNAME> [--endpoint-type <endpoint type>]

Le informazioni di connessione complete vengono restituite dal comando ibmcloud cdb deployment-connections con l'indicatore --all. Per recuperare tutte le informazioni sulle connessioni dell'installazione client, usare il seguente comando:

ibmcloud cdb deployment-connections <INSTANCE_NAME_OR_CRN> -u <NEWUSERNAME> --all [--endpoint-type <endpoint type>]

Se non specifichi un utente, i comandi deployment-connections restituiscono le informazioni per l'utente amministratore per impostazione predefinita. Se non si specifica un tipo di endpoint, la stringa di connessione restituisce l'endpoint pubblico per impostazione predefinita. Se la tua distribuzione ha solo un endpoint privato, devi specificare --endpoint-type private o i comandi restituiscono un errore. L'utente e il tipo di endpoint non sono applicati. Puoi utilizzare qualsiasi utente sulla tua distribuzione con entrambi gli endpoint (se entrambi esistono nella tua distribuzione).

Per utilizzare i comandi CLI ibmcloud cdb, devi installare il plug-in Cloud Databases.

Ottenere le stringhe di connessione dall'API

Per richiamare le stringhe di connessione dall'API, utilizza l'endpoint /users/{userid}/connections. È necessario specificare nel percorso quale utente e quale tipo di endpoint (pubblico o privato) viene utilizzato nelle stringhe di connessione restituite. L'utente e il tipo di endpoint non sono applicati. Puoi utilizzare qualsiasi utente sulla tua distribuzione con entrambi gli endpoint (se entrambi esistono nella tua distribuzione).

curl -X GET https://api.{region}.databases.cloud.ibm.com/v5/ibm/deployments/{id}/users/{user_type}/{user_id}/connections/{endpoint_type} \
-H 'Authorization: Bearer <>' \

Più utenti e stringhe di connessione

L'accesso alla distribuzione Databases for Redis non è limitato all'utente amministratore. È possibile creare utenti utilizzando la Credenziali di servizio pagina, la IBM CLI di Cloud o attraverso le IBM Cloud Databases API.

Tutti gli utenti nella tua distribuzione possono utilizzare le stringhe di connessione, incluse le stringhe di connessione per endpoint pubblici o privati.

Creare utenti dall'interfaccia utente

Andate alla pagina di dettaglio della risorsa per il vostro servizio.
Fare clic su Credenziali di servizio per aprire la pagina Credenziali di servizio.
Fai clic su New credential.
Scegliere un nome descrittivo per la nuova credenziale.
(Facoltativo) Specificare se le nuove credenziali utilizzano un endpoint pubblico o privato. Usare { "service-endpoints": "public" } / { "service-endpoints": "private" } nel campo Aggiungi parametri di configurazione in linea per generare stringhe di connessione usando l'endpoint specificato. L'uso dell'endpoint non viene imposto, poiché controlla quali nomi di host sono presenti nelle stringhe di connessione. Gli endpoint pubblici sono generati per impostazione predefinita.
Fare clic su Aggiungi per eseguire il provisioning delle nuove credenziali. Vengono generati automaticamente un nome utente e una password e un utente Redis associato.

Le nuove credenziali appaiono nella tabella e le stringhe di connessione sono disponibili come JSON in un campo da copiare con un clic in Visualizza credenziali.

Creazione di utenti dalla CLI

Se si gestisce il servizio tramite la IBM Cloud CLI e la plug-in per i database cloud, è possibile creare un nuovo utente con la cdb user-create. Ad esempio, per creare un nuovo utente per una "distribuzione di esempio", utilizzare il seguente comando.

ibmcloud cdb user-create example-deployment <NEWUSERNAME> <NEWPASSWORD>

Una volta terminata l'operazione, è possibile recuperare le stringhe di connessione del nuovo utente con il comando ibmcloud cdb deployment-connections.

Creare utenti con l'API

L'endpoint di Foundation, visualizzato nel pannello Panoramica del servizio, fornisce l'URL di base per accedere a questa installazione client attraverso l'API. Per creare e gestire gli utenti, utilizzare l'URL di base con l'endpoint '/users.

curl -X POST 'https://api.{region}.databases.cloud.ibm.com/v5/ibm/deployments/{id}/users/{user_type}' \
-H "Authorization: Bearer $APIKEY" \
-H "Content-Type: application/json" \
-d '{"user": {"username": "user", "password": "v3ry-1-secUre-pAssword-2"}}'

Per recuperare le stringhe di connessione di un utente, utilizzare l'URL di base con l'endpoint '/users/{userid}/connections.

Aggiunta di utenti alle credenziali del servizio nell'interfaccia utente

La creazione di un nuovo utente dalla CLI non comporta il popolamento automatico delle stringhe di connessione dell'utente nelle credenziali di servizio. Se si desidera aggiungerli, è possibile creare una nuova credenziale con le informazioni dell'utente esistente.

Immettere il nome utente e la password nel campo JSON Aggiungi parametri di configurazione in linea, oppure specificare un file in cui memorizzare le informazioni JSON. Ad esempio, inserendo {"existing_credentials":{"username":"Robert","password":"supersecure"}} nel campo si generano credenziali di servizio con il nome utente "Robert" e la password "supersecure" inseriti nelle stringhe di connessione.

La generazione di credenziali da un utente esistente non controlla né crea tale utente.

Suddivisione stringa di connessione

La sezione Redis

La sezioneRedis" di una credenziale creata nella pagina delle credenziali di servizio contiene informazioni adatte alle applicazioni che si connettono a Redis.

Informazioni sulla connessioneRedis
Nome campo	Indice	Descrizione
`Type`		Tipo di connessione: per Redis è "URI".
`Scheme`		Schema per un URI: per Redis, è "rediss".
`Path`		Percorso per l'URI - per Redis, è il numero del database.
`Authentication`	`Username`	Il nome utente utilizzato per la connessione.
`Authentication`	`Password`	Una password per l'utente - potrebbe essere visualizzata come `$PASSWORD`.
`Authentication`	`Method`	Come avviene l'autenticazione; l'autenticazione "diretta" è gestita dal driver.
`Hosts`	`0...`	Un nome di host e una porta a cui connettersi.
`Composed`	`0...`	Un URI che combina Schema, autenticazione, host e percorso.
`Certificate`	`Name`	Il nome assegnato per il certificato proprietario del servizio per la distribuzione del database.
`Certificate`	Base64	Una versione codificata base64 del certificato.

0... indica che in un array potrebbero essere presenti una o più di queste voci.

Per ulteriori informazioni, vedere Collegamento di un'applicazione esterna.

La sezione CLI

La sezione "CLI" di una credenziale creata nella pagina Credenziali del servizio contiene informazioni adatte ai client a riga di comando che effettuano connessioni a Redis.

Informazioni sulla connessioneRedis
Nome campo	Indice	Descrizione
`Bin`		Il binario consigliato per creare una connessione; in questo caso è `redli`.
`Composed`		Un comando formattato per stabilire una connessione alla tua distribuzione. Il comando combina l'eseguibile `Bin`, le impostazioni delle variabili `Environment` e utilizza `Arguments` come parametri della riga di comando.
`Environment`		Un elenco di chiavi o valori impostati come variabili di ambiente.
`Arguments`	0...	Le informazioni che vengono passate come argomenti al comando, visualizzate nel campo Bin.
`Certificate`	Base64	Un certificato proprietario del servizio che viene utilizzato per confermare che un'applicazione si sta connettendo al server appropriato. Ha una codifica base64.
`Certificate`	Nome	Il nome assegnato per il certificato proprietario del servizio.
`Type`		Il tipo di pacchetto che utilizza queste informazioni di connessione; in questo caso `cli`.

0... indica che in un array potrebbero essere presenti una o più di queste voci.

Per ulteriori informazioni, vedere Connessione con un client da riga di comando.