Obtendo sequências de conexões

O serviço IBM Cloud® Databases for Redis é provisionado com a autenticação ativada. São necessários um nome do usuário, uma senha e sequências de conexões para conectar e emitir comandos.

As cadeias de conexão de sua implementação são exibidas na página Overview (Visão geral), no painel Endpoints. Todos os usuários em sua implementação podem usar as sequências de conexões, incluindo sequências de conexões para terminais públicos ou privados.

Sua string de conexão será padrão para banco de dados 0. No entanto, modificar sua conexão para se conectar a um banco de dados diferente de 0 é suportado.

Sua implementação do Redis é provisionada com um usuário administrativo. Deve-se configurar a senha do administrador para que seja possível usá-la para conexão com o banco de dados. Para obter mais informações, consulte a página Configurando a senha do administrador.

Obtenção de cadeias de conexão na interface do usuário

Siga estas etapas para recuperar as cadeias de conexão da instância Databases for Redis:

Na página Overview (Visão geral) da sua implementação, role para baixo até a seção Endpoints (Pontos de extremidade ).
Na seção Endpoints, você encontra uma guia Início rápido com as seguintes seções:
- Conectar-se usando uma CLI- Esta seção contém informações sobre como conectar-se à sua implementação por meio da IBM CLI.
- Conectar-se usando um cliente Redis- Esta seção permite obter um certificado TLS e conectar-se à sua implantação.

Obtendo sequências de conexões por meio da CLI

Você pode agarrar strings de conexão a partir do CLI.

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

Informações de conexão integrais são retornadas pelo comando ibmcloud cdb deployment-connections com a sinalização --all. Para recuperar todas as informações de conexão de sua implantação, use o seguinte comando:

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

Se você não especificar um usuário, os comandos deployment-connections retornarão informações para o usuário admin por padrão. Se você não especificar um tipo de terminal, a sequência de conexões retornará o terminal público por padrão. Se a sua implementação tiver apenas um terminal privado, você deverá especificar --endpoint-type private ou os comandos retornarão um erro. O tipo de usuário e de terminal não é imposto. Será possível usar qualquer usuário em sua implementação com qualquer terminal (se ambos existirem em sua implementação).

Para usar os comandos da CLI ibmcloud cdb, deve-se instalar o plug-in do Cloud Databases.

Obtendo sequências de conexões por meio da API

Para recuperar as sequências de conexões da API, use o terminal /users/{userid}/connections. Deve-se especificar no caminho qual usuário e qual tipo de terminal (público ou privado) é utilizado nas sequências de caracteres de conexão retornadas. O tipo de usuário e de terminal não é imposto. Será possível usar qualquer usuário em sua implementação com qualquer terminal (se ambos existirem em sua implementação).

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

Mais usuários e sequências de conexões

O acesso à sua implementação do Databases for Redis não é limitado ao usuário administrativo. Você pode criar usuários usando a página Credenciais do serviço, a CLI do IBM Cloud ou a API do IBM Cloud Databases.

Todos os usuários em sua implementação podem usar as sequências de conexões, incluindo sequências de conexões para terminais públicos ou privados.

Criação de usuários a partir da interface do usuário

Navegue até a página de detalhes do recurso para seu serviço.
Clique em Credenciais de serviço para abrir a página Credenciais de serviço.
Clique em Nova credencial.
Escolha um nome descritivo para a sua nova credencial.
(Opcional) Especificar se as novas credenciais usam um terminal público ou privado. Use { "service-endpoints": "public" } / { "service-endpoints": "private" } no campo Incluir Parâmetros de Configuração Sequencial para gerar sequências de conexão usando o terminal especificado. O uso do endpoint não é obrigatório, pois ele controla quais nomes de host estão nas cadeias de conexão. Os terminais públicos são gerados por padrão.
Clique em Incluir para provisionar as novas credenciais. São gerados automaticamente um nome de usuário e uma senha e um usuário associado ao Redis.

As novas credenciais aparecem na tabela, e as sequências de conexão estarão disponíveis como JSON em um campo click-to-copy sob Visualizar Credenciais.

Criação de usuários a partir da CLI

Se você gerenciar o seu serviço por meio da CLI da IBM Cloud e do plug-in de bancos de dados em nuvem, será possível criar um novo usuário com cdb user-create. Por exemplo, para criar um novo usuário para uma "implementação de exemplo", use o comando a seguir.

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

Assim que a tarefa for concluída, será possível recuperar as novas sequências de conexões do usuário com o comando ibmcloud cdb deployment-connections.

Criação de usuários com a API

O Terminal de Fundação mostrado no painel Visão geral do seu serviço fornece a URL base para acessar essa implementação por meio da API. Para criar e gerenciar usuários, use a URL base com o terminal /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 as sequências de conexões de um usuário, use a URL base com o terminal /users/{userid}/connections.

Adição de usuários a credenciais de serviço na interface do usuário

A criação de um novo usuário da CLI não preenche automaticamente as sequências de conexão desse usuário nas Credenciais de serviço. Se você desejar inclui-las lá, será possível criar uma nova credencial com as informações do usuário existentes.

Insira o nome de usuário e a senha no campo JSON Incluir parâmetros de configuração embutidos ou especifique um arquivo onde as informações JSON são armazenadas. Por exemplo, colocar {"existing_credentials":{"username":"Robert","password":"supersecure"}} no campo gera Credenciais de serviço com o nome de usuário "Robert" e a senha "superseguro" preenchidos nas sequências de conexão.

A geração de credenciais de um usuário existente não verifica ou cria esse usuário.

Detalhamento da sequência de conexões

A seção Redis

A seçãoRedis" de uma credencial criada na página Credenciais de serviço contém informações adequadas aos seus aplicativos que fazem conexões com o Redis.

Informações de conexãoRedis
Nome do campo	Index	Descrição
`Type`		Tipo de conexão - para Redis, é "URI".
`Scheme`		Esquema para um URI - para Redis, é "rediss".
`Path`		Caminho para um URI - para Redis, é o número do banco de dados.
`Authentication`	`Username`	O nome do usuário usado para se conectar.
`Authentication`	`Password`	Uma senha para o usuário - pode ser mostrada como `$PASSWORD`.
`Authentication`	`Method`	Como a autenticação ocorre; a autenticação "direta" é manipulada pelo driver.
`Hosts`	`0...`	Um nome do host e uma porta aos quais se conectar.
`Composed`	`0...`	Um URI que combina Scheme, autenticação, host e caminho.
`Certificate`	`Name`	O nome alocado para o certificado proprietário do serviço para a implementação do banco de dados.
`Certificate`	Base64	Uma versão do certificado codificada em Base64.

0... indica que pode haver uma ou mais dessas entradas em uma matriz.

Para obter mais informações, consulte Conexão de um aplicativo externo.

A seção CLI

A seção "CLI" de uma credencial criada na página Credenciais de serviço contém informações que são adequadas para clientes de linha de comando que fazem conexões com o Redis.

Informações de conexãoRedis
Nome do campo	Index	Descrição
`Bin`		O binário recomendado para a criação de uma conexão; nesse caso, `redli`.
`Composed`		Um comando formatado para estabelecer uma conexão com a sua implementação. O comando combina o executável `Bin`, as configurações da variável `Environment` e usa `Arguments` como parâmetros da linha de comandos.
`Environment`		Uma lista de chaves ou de valores configurados como variáveis de ambiente.
`Arguments`	0...	As informações transmitidas como argumentos para o comando mostrado no campo Bin.
`Certificate`	Base64	Um certificado proprietário de serviço usado para confirmar que um aplicativo está se conectando ao servidor apropriado. Ele é codificado em base64.
`Certificate`	Nome	O nome alocado para o certificado de propriedade do serviço.
`Type`		O tipo de pacote que usa essas informações de conexão; neste caso, `cli`.

0... indica que pode haver uma ou mais dessas entradas em uma matriz.

Para obter mais informações, consulte Conexão com um cliente de linha de comando.