Obtención de series de conexión

El servicio IBM Cloud® Databases for Redis se suministra con la autenticación habilitada. Necesita un nombre de usuario, una contraseña y series de conexión para conectar y emitir mandatos.

Las cadenas de conexión de su implantación se muestran en la página Descripción general, en el panel Puntos finales. Todos los usuarios del despliegue pueden utilizar las series de conexión, incluidas las series de conexión para los puntos finales públicos o privados.

La serie de conexión tomará como valor predeterminado la base de datos 0. Sin embargo, se da soporte a la modificación de la conexión para conectarse a una base de datos que no sea 0.

El despliegue de Redis se suministra con un usuario de administración. Debe establecer la contraseña de administrador antes de poder utilizarla para conectar con la base de datos. Para obtener más información, consulte la página Configuración de la contraseña de administrador.

Obtención de cadenas de conexión desde la interfaz de usuario

Siga estos pasos para recuperar las cadenas de conexión de su instancia Databases for Redis:

En la página Descripción general de la implantación, desplácese hasta la sección Endpoints.
Dentro de la sección Endpoints, encontrará una pestaña de inicio rápido con las siguientes secciones:
- Conectarse mediante una CLI: esta sección contiene información para conectarse a su despliegue a través de la CLI IBM CLI.
- Conectarse usando un cliente Redis- Esta sección le permite obtener un certificado TLS y conectarse a su despliegue.

Obtención de series de conexión desde la CLI

Puede obtener series de conexión desde la CLI.

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

El mandato ibmcloud cdb deployment-connections devuelve información de conexión completa si se utiliza el distintivo --all. Para recuperar toda la información de conexión de su implantación, utilice el siguiente comando:

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

Si no especifica un usuario, los mandatos deployment-connections devuelven información para el usuario admin de forma predeterminada. Si no especifica un tipo de punto final, la serie de conexión devuelve el punto final público de forma predeterminada. Si el despliegue solo tiene un punto final privado, debe especificar --endpoint-type private, si no, los mandatos devuelven un error. El usuario y el tipo de punto final no se imponen. Puede utilizar cualquier usuario del despliegue con cualquiera de los puntos finales (si ambos existen en el despliegue).

Para utilizar los mandatos de CLI de ibmcloud cdb, debe instalar el plugin de Cloud Databases.

Obtención de series de conexión desde la API

Para recuperar las series de conexión de usuario de la API, utilice el punto final /users/{userid}/connections. Debe especificar en la vía de acceso qué usuario y qué tipo de punto final (público o privado) se utiliza en las series de conexión devueltas. El usuario y el tipo de punto final no se imponen. Puede utilizar cualquier usuario del despliegue con cualquiera de los puntos finales (si ambos existen en el despliegue).

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 <>' \

Usuarios y series de conexión adicionales

El acceso a su despliegue de Databases for Redis no está limitado al usuario administrador. Puede crear usuarios utilizando la página Credenciales de servicio, la CLI de IBM Cloud o a través de la API de IBM Cloud Databases.

Todos los usuarios del despliegue pueden utilizar las series de conexión, incluidas las series de conexión para los puntos finales públicos o privados.

Crear usuarios desde la interfaz de usuario

Vaya a la página de detalles del recurso correspondiente a su servicio.
Haga clic en Credenciales de servicio para abrir la página Credenciales de servicio.
Pulse Nueva credencial.
Elija un nombre descriptivo para la nueva credencial.
(Opcional) Especifique si las nuevas credenciales utilizan un punto final público o privado. Utilice { "service-endpoints": "public" } / { "service-endpoints": "private" } en el campo Añadir parámetros de configuración en línea para generar series de conexión utilizando el punto final especificado. El uso del punto final no es obligatorio, ya que controla qué nombres de host aparecen en las cadenas de conexión. De forma predeterminada, se generan puntos finales públicos.
Pulse Añadir para suministrar las nuevas credenciales. Se generan automáticamente un nombre de usuario y una contraseña, así como un usuario Redis asociado.

Las nuevas credenciales aparecen en la tabla y las series de conexión están disponibles como JSON en un campo de pulsar para copiar en Ver credenciales.

Creación de usuarios desde la CLI

Si gestiona el servicio mediante la CLI de IBM Cloud y el plugin de Cloud Databases, puede crear un nuevo usuario con cdb user-create. Por ejemplo, para crear un nuevo usuario para un despliegue llamado "example-deployment", utilice el mandato siguiente.

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

Una vez finalizada la tarea, puede recuperar las series de conexión del nuevo usuario con el mandato ibmcloud cdb deployment-connections.

Creación de usuarios con la API

El Punto final básico que se muestra en el panel Visión general del servicio proporciona el URL base para acceder a este despliegue a través de la API. Para crear y gestionar usuarios, utilice el URL base con el punto final /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"}}'

Para recuperar las series de conexión de un usuario, utilice el URL base con el punto final /users/{userid}/connections.

Añadir usuarios a las credenciales de servicio en la interfaz de usuario

La creación de un nuevo usuario desde la CLI no llena automáticamente las series de conexión de ese usuario en las Credenciales de servicio. Si desea añadirlas, puede crear una nueva credencial con la información del usuario existente.

Especifique el nombre de usuario y la contraseña en el campo JSON Añadir parámetros de configuración en línea o especifique un archivo donde se almacena la información de JSON. Por ejemplo, poner {"existing_credentials":{"username":"Robert","password":"supersecure"}} en el campo genera Credenciales de servicio con el nombre de usuario "Robert" y la contraseña "supersecure" llenados en las series de conexión.

Al generar credenciales de un usuario existente no se comprueba ni se crea dicho usuario.

Desglose de serie de conexión

La sección Redis

La secciónRedis" de una credencial creada en la página Credenciales de servicio contiene información adecuada para las aplicaciones que establecen conexiones con Redis.

Información de conexiónRedis
Nombre de campo	Índice	Descripción
`Type`		Tipo de conexión - para Redis, es "URI".
`Scheme`		Esquema para un URI - para Redis, es "rediss".
`Path`		Ruta para un URI - para Redis, es el número de base de datos.
`Authentication`	`Username`	El nombre de usuario que utiliza para conectarse.
`Authentication`	`Password`	Una contraseña para el usuario - podría mostrarse como `$PASSWORD`.
`Authentication`	`Method`	Cómo se realiza la autenticación; la autenticación "directa" la maneja el controlador.
`Hosts`	`0...`	Un nombre de host y un puerto al que conectar.
`Composed`	`0...`	Un URI que combina Scheme, autenticación, host y ruta.
`Certificate`	`Name`	El nombre asignado para el certificado propietario del servicio para el despliegue de la base de datos.
`Certificate`	Base64	Una versión codificada en base64 del certificado.

0... indica que puede haber una o varias de estas entradas en una matriz.

Para más información, consulte Conexión de una aplicación externa.

La sección CLI

La sección "CLI" de una credencial creada en la página de credenciales de servicio contiene información adecuada para clientes de línea de comandos que establecen conexiones con Redis.

Información de conexiónRedis
Nombre de campo	Índice	Descripción
`Bin`		El binario recomendado para crear una conexión; en este caso es `redli`.
`Composed`		Un mandato con formato para establecer una conexión con el despliegue. El mandato combina el ejecutable `Bin`, los valores de variable `Environment` y utiliza `Arguments` como parámetros de línea de mandatos.
`Environment`		Una lista de claves o valores que establece como variables de entorno.
`Arguments`	0...	La información que se pasa como argumentos al mandato que se muestra en el campo Bin.
`Certificate`	Base64	Certificado propietario de un servicio que se utiliza para confirmar que una aplicación se está conectando al servidor adecuado. Está codificado en base64.
`Certificate`	Nombre	El nombre asignado para el certificado propietario del servicio.
`Type`		El tipo de paquete que utiliza esta información de conexión; en este caso `cli`.

0... indica que puede haber una o varias de estas entradas en una matriz.

Para más información, consulte Conexión con un cliente de línea de comandos.