Autenticando para IBM Cloud

IBM Cloud

Você usa o IBM Cloud® Identity and Access Management (IAM) para fazer solicitações autenticadas para serviços públicos do IBM Watson®. É possível transmitir um token de acesso em um cabeçalho de autorização ou uma chave de API.

• Autenticar com um token do IAM.

  Os tokens do IAM são credenciais de segurança temporárias válidas por até 60 minutos. Quando um token expira, você gera um novo. Os tokens podem ser úteis para o acesso provisório aos recursos. Para obter mais informações, consulte Gerando um token do IAM do IBM Cloud usando uma chave de API.

  O comando curl a seguir gera um token de acesso IAM. Substitua {apikey} pelo valor de sua chave de API.

  curl -X POST \
  -header "Content-Type: application/x-www-form-urlencoded" \
  -data "grant_type=urn:ibm:params:oauth:grant-type:apikey&apikey={apikey}" \
  "https://iam.cloud.ibm.com/identity/token"
  

  A resposta inclui uma propriedade access_token. Para autenticar uma solicitação para o serviço, substitua {access_token} pelo token da resposta. Substitua {url} pelo valor da URL para sua instância de serviço, que você pode encontrar clicando em Mostrar Credenciais na caixa Credenciais da página Gerenciar para sua instância de serviço.

  curl -header "Authorization: Bearer {access_token}" \
  "{url}/v1/{method}"
  

• Autenticar com uma chave de API do IBM Cloud, uma chave de API do ID de serviço ou uma chave de API específica do serviço. Substitua {url} pelo valor da URL para sua instância de serviço, que você pode encontrar clicando em Mostrar Credenciais na caixa Credenciais da página Gerenciar para sua instância de serviço.

  As chaves de API são simples de usar e não expiram automaticamente. Qualquer pessoa com uma chave válida pode acessar o recurso. É possível criar chaves de API separadas para usuários diferentes, para aplicativos diferentes ou para suportar cenários de rotação de chave. É possível revogar as chaves de API do console sem interferir em outras chaves de API ou no usuário.

  O exemplo a seguir curl se autenca com a chave API f5sAznhrKQyvBFFaZbtF60m5tzLbqWhyALQawBg5TjRI.

  curl -u "apikey:f5sAznhrKQyvBFFaZbtF60m5tzLbqWhyALQawBg5TjRI" \
  "{url}/v1/{method}"
  

Para teste e desenvolvimento, é possível transmitir uma chave de API diretamente. No entanto, para uso de produção, a menos que você use os SDKs do Watson, use um token do IAM. Ao transmitir uma chave de API, o serviço consulta os detalhes da chave de API, portanto, isso pode afetar o desempenho. Para obter mais informações, consulte Chamando as APIs de serviço do IBM Cloud.

Os SDKs do Watson suportam ambos os métodos. Para obter mais informações, consulte a seção Autenticação da referência da API para o seu serviço e SDK.

Alguns planos de serviço suportam IBM® Key Protect for IBM Cloud® para controlar o acesso aos dados. Para obter mais informações, consulte Protegendo informações confidenciais em seu serviço do Watson.

Autenticando para IBM Cloud Pak for Data

IBM Cloud Pak for Data

Você se autentica no serviço passando um token de acesso com cada solicitação. Você passa um token de acesso em um cabeçalho Authorization para autenticar. Vários métodos existem para gerar o token, incluindo ao usar uma chave de API ou por nome do usuário. Para obter mais informações, consulte Gerando um token de autorização ou chave API.

Para obter mais informações sobre métodos de autenticação que são suportados pelos SDKs Watson para serviços instalados em IBM Cloud Pak for Data, veja a seção Autenticação da referência da API para o seu serviço e SDK.