Após publicar uma API, conceda a outros workspaces as permissões para chamá-la ou visualize as APIs que seu workspace já tem permissão para acessar, viabilizando o compartilhamento de dados. Este tópico descreve como conceder as permissões necessárias para chamar uma API em diferentes cenários.
Pré-requisitos
Somente é possível cancelar a publicação, autorizar o acesso ou alterar os protocolos de APIs após publicá-las. Para mais informações, consulte Teste, publicação e gerenciamento de versão de API.
Acessar a página Gerencie APIs
Faça login no console do DataWorks. Na região desejada, clique em no painel de navegação à esquerda. Selecione um workspace na lista suspensa e clique em Go to DataService Studio.
Na barra de menus superior, clique em Service Management para acessar a página Manage APIs.
Conceder permissões para chamar uma API
Na aba Published APIs, localize a API desejada e clique em Authorization.
-
Na caixa de diálogo API Authorization, configure os parâmetros.
Após conceder a autorização, os membros do workspace de destino poderão visualizar a API na aba Gerencie APIs > APIs Authorized for Me e chamá-la usando o AppCode ou o AppKey e AppSecret do workspace deles. Para gerenciar ou revogar autorizações, acesse a aba Gerencie APIs > APIs I Have Authorized e clique em Gerencie Authorization. Para adicionar outras credenciais, acesse o console do API Gateway, navegue até Call API > Application Management, crie um novo aplicativo e autorize-o. Nota: Se você cancelar a publicação ou excluir uma API, as autorizações existentes tornar-se-ão inválidas. Execute essas ações com cautela.
Parâmetro
Descrição
API Name
Nome da API para a qual você deseja conceder permissão de chamada a um workspace. Não é possível alterar o valor deste parâmetro.
Tenant Account ID
ID da conta Alibaba Cloud que receberá a permissão para chamar a API. É possível visualizá-lo na página Security Settings.
Authorized Workspace
Nome do workspace ao qual você deseja conceder as permissões para chamar a API. Selecione na lista suspensa um workspace pertencente à conta Alibaba Cloud atual.
Authorization Validity Period
Período de validade da permissão de chamada da API. Os valores válidos são Limited e Unlimited.
-
Limited: Selecione uma data de expiração. A API poderá ser chamada até essa data.
-
Unlimited: Ao selecionar Unlimited, a permissão para chamar a API será permanente.
-
-
Clique em Confirm.
Na aba Published APIs, também é possível executar as seguintes operações:
-
Clique em Unpublish ao lado da API. Na caixa de diálogo Unpublish API, clique em Confirm.
NotaSe você cancelar a publicação ou excluir uma API após conceder permissão de chamada a um workspace, esse workspace não poderá mais chamar a API.
Ao republicar uma API depois de cancelar sua publicação ou modificá-la, conceda novamente as permissões de chamada ao workspace relacionado.
Clique em Test ao lado da API para acessar a página API Test. Para mais informações, consulte Testar uma API.
-
Passe o mouse sobre More ao lado da API e clique em Change Protocol. Na caixa de diálogo Change Protocol, defina o novo protocolo da API e clique em Confirm.
NotaAo excluir um protocolo, a API não poderá mais ser chamada por meio dele. Tenha cautela ao executar esta operação.
A alteração de protocolo entra em vigor em tempo real.
-
Visualizar as APIs que seu workspace tem permissão para chamar
Na página Manage APIs, clique na aba Authorized to Use para ver todas as APIs autorizadas para você.
Nas APIs que seu workspace tem permissão para chamar, é possível executar as seguintes operações:
Clique em Test ao lado da API para acessar a página API Test. Para mais informações, consulte Testar uma API.
Clique em Delete ao lado da API. Na caixa de diálogo Delete authorized, clique em Confirm.
Visualizar as APIs para as quais você concedeu permissão a outros workspaces
Na página Manage APIs, clique na aba Authorize Others to Use para ver todas as APIs que você autorizou para terceiros.
Nas APIs para as quais você concedeu permissão de chamada a outros workspaces, é possível executar as seguintes operações:
Clique em Test ao lado da API para acessar a página API Test. Para mais informações, consulte Testar uma API.
Clique em Manage ao lado da API. Na caixa de diálogo Authorization, revogue ou modifique a autorização de um workspace.
Recurso de autorização de API
O recurso de autorização de API concede a aplicativos as permissões necessárias para chamar APIs. Um aplicativo representa uma identidade usada para chamar APIs. Para efetuar uma chamada, conceda ao aplicativo as devidas permissões. Por padrão, o Alibaba Cloud APP, suportado pelo DataWorks DataService Studio, autentica a identidade do usuário durante as chamadas de API em um workspace. O DataWorks DataService Studio concede ao aplicativo com o mesmo nome do workspace as permissões para chamar uma API dentro desse workspace. Dessa forma, o chamador pode usar o AppCode, AppKey e AppSecret do aplicativo para chamar a API com segurança. Para mais informações, consulte Chamar uma API.
Durante a chamada de uma API, podem surgir questões específicas, como identificar e distinguir a origem da chamada ou alocar corretamente as informações de autenticação. Esta seção explica como conceder permissões para chamar APIs do DataService Studio em diferentes granularidades e cenários, conforme as necessidades do seu negócio.
Cenário 1: Membros de um workspace do DataWorks usam o mesmo aplicativo para chamar APIs
Cenário 2: Cada usuário RAM usa um aplicativo próprio e separado para chamar APIs
Cenário 3: Usuários RAM do mesmo grupo usam o mesmo aplicativo para chamar APIs
