Gerenciador de Segredos Sem Chaves (Versão Prévia)
Conector sem chave para api.akeyless.io: listar e descrever itens do cofre, ler valores secretos e administrar funções, gateways, destinos e métodos de autenticação. Dá suporte a gravações opcionais para criar ou atualizar segredos e mover objetos de acordo com o RBAC de sua conta. A conexão usa HTTP Basic com a ID de acesso à chave de API sem chave e a chave de acesso. Consulte readme.md para obter referências de configuração de credenciais e de API.
Esse conector está disponível nos seguintes produtos e regiões:
| Service | Classe | Regions |
|---|---|---|
| Copilot Studio | Premium | Todas as regiões Power Automate exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Aplicativos Lógicos | Standard | Todas as regiões dos Aplicativos Lógicos , exceto as seguintes: – Azure Governamental regiões - Regiões do Azure China - Departamento de Defesa dos EUA (DoD) |
| Power Apps | Premium | Todas as regiões Power Apps exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Power Automate | Premium | Todas as regiões Power Automate exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Contato | |
|---|---|
| Name | Sem chaves |
| URL | https://www.akeyless.io/ |
| simon.f@akeyless.io |
| Metadados do conector | |
|---|---|
| Publicador | Sem chaves |
| Website | https://www.akeyless.io/ |
| Política de privacidade | https://www.akeyless.io/privacy-policy |
| Categories | Segurança;Operações de TI |
| Suporte | https://www.akeyless.io/support/ |
Gerenciador de Segredos Sem Chaves
Akeyless é uma plataforma de gerenciamento de segredos. Esse conector chama a API api.akeyless.io REST sem chaves para que os criadores possam listar itens do cofre, ler valores secretos, inspecionar funções e infraestrutura e, opcionalmente, criar, atualizar, excluir ou mover itens de acordo com a função chave de API.
Publicador
Sem chaves
Prerequisites
- Uma conta sem chave.
- Um método de autenticação de chave de API (ID de acesso e chave de acesso). Crie um no Console sem Chave em Administração → Métodos de Autenticação → Chave de API. A Chave de Acesso é mostrada uma vez; armazene-o com segurança. Consulte Autenticar com a Chave de API.
- Uma Função de Acesso que concede apenas os recursos de que cada fluxo precisa (RBAC).
Connection
A conexão usa a autenticação HTTP Basic:
- ID de acesso sem chave (nome de usuário do protocolo)
- Chave de acesso sem chave (senha de protocolo)
Não insira um conta Microsoft email ou senha de console. As credenciais são enviadas para a Akeyless /auth com access-typeaccess_key. Os órgãos de ação não aceitam a ID de Acesso ou a Chave de Acesso.
Operações com suporte
Ações primárias (importante):
- Itens de Lista — pastas e metadados de item em um caminho
- Descrever Item — metadados para um caminho de item
-
Obter Segredo – retorna um
SecretValuecampo -
Obter senha – retorna
usernameepasswordcampos quando o segredo é armazenado como credenciais
As ações avançadas incluem a listagem de métodos de autenticação, funções, gateways, destinos, grupos, segredos da USC, marcas, análise e operações de gravação (Criar Segredo, Atualizar Item, Excluir Item, Mover Objetos). Restrinja a função chave de API antes de usar gravações.
Limitações e problemas conhecidos
- Os valores secretos retornados por Get Secret e Get Password aparecem nas saídas de execução de fluxo. Limite quem pode exibir esses fluxos.
- Operações de gravação alteram dados no Akeyless. Teste primeiro em uma área restrita.
- A cor da marca é
#0E4D45.
Suporte
- Produto: https://www.akeyless.io/
- Documentação: https://docs.akeyless.io/
- Privacidade: https://www.akeyless.io/privacy-policy
- Suporte: https://www.akeyless.io/support/
Criando uma conexão
O conector dá suporte aos seguintes tipos de autenticação:
| Default | Parâmetros para criar conexão. | Todas as regiões | Não compartilhável |
Padrão
Aplicável: todas as regiões
Parâmetros para criar conexão.
Essa não é uma conexão compartilhável. Se o aplicativo de energia for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.
| Name | Tipo | Descrição | Required |
|---|---|---|---|
| ID de acesso sem chave | secureString | Sua ID de acesso sem chave (autenticação de chave de API). Esse valor é enviado como o nome de usuário de autenticação HTTP Basic – não é um nome de usuário Microsoft. | True |
| Chave de acesso sem chave | secureString | Sua chave de acesso sem chave (segredo). Esse valor é enviado como a senha de autenticação HTTP Basic– não é sua senha de Microsoft. | True |
Ações
| Atualizar item |
Gravação: atualiza metadados de item e/ou valor de segredo estático (usa |
| Criar segredo |
Gravação: cria um segredo estático. Consulte create-secret. |
| Descrever Item |
Retorna metadados de um item por caminho ou id. Consulte describe-item. |
| Excluir item |
Gravação: exclui ou agenda a exclusão. Consulte delete-item. |
| Itens da Lista |
Lista pastas e itens em um caminho de cofre. Consulte itens de lista. |
| Lista USC |
Lista segredos para um Conector de Segredos Universais. Consulte usc-list. |
| Listar destinos |
Lista os destinos de integração. Consulte list-targets. |
| Listar funções |
Lista funções. Consulte list-roles. |
| Listar gateways |
Lista gateways. Consulte list-gateways. |
| Listar grupos |
Lista grupos. Consulte grupos de listas. |
| Listar métodos de autenticação |
Lista os métodos de autenticação. Consulte list-auth-methods. Opcional |
| Mover objetos |
Gravação: move ou renomeia itens, métodos de autenticação ou funções. Consulte move-objects. |
| Obtenção de destino |
Retorna um destino por nome. Consulte target-get. |
| Obter dados de análise |
Retorna dados de análise/uso. Consulte get-analytics-data. |
| Obter função |
Retorna uma função por nome. Consulte get-role. |
| Obter método de autenticação |
Retorna um método de autenticação por nome. Consulte get-auth-method. |
| Obter Segredo |
Recupera um valor secreto. Use a conexão para a ID de Acesso/Chave de Acesso; forneça apenas o caminho do segredo. |
| Obter senha |
Recupera um segredo de estilo de nome de usuário/senha estruturado. Mesma conexão; forneça apenas o caminho do segredo. |
| Obter tags |
Retorna marcas para um caminho de item. Consulte get-tags. |
Atualizar item
Gravação: atualiza metadados de item e/ou valor de segredo estático (usa /update-item e/ou /update-secret-val como MCP). Consulte update-item e update-secret-val.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Name
|
name | True | string |
Caminho do item atual. |
|
Novo valor
|
new_value | string |
Novo valor secreto para segredos estáticos. |
|
|
Manter a versão de pré-desenvolvimento
|
keep_prev_version | boolean |
Manter a versão de pré-desenvolvimento. |
|
|
Descrição
|
description | string |
Description. |
|
|
Novo nome
|
new_name | string |
Novo Nome. |
|
|
Adicionar marcas
|
add_tags | array of string |
Adicionar marcas. |
|
|
Remover marcas
|
remove_tags | array of string |
Remover marcas. |
|
|
Versões máximas
|
max_versions | string |
Versões máximas. |
|
|
Excluir Proteção
|
delete_protection | boolean |
Excluir Proteção. |
Retornos
- response
- object
Criar segredo
Gravação: cria um segredo estático. Consulte create-secret.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Name
|
name | True | string |
Caminho completo do novo segredo. |
|
Value
|
value | True | string |
Material secreto. |
|
Descrição
|
description | string |
Description. |
|
|
Tags
|
tags | array of string |
Etiquetas. |
|
|
Chave de proteção
|
protection_key | string |
Chave de proteção. |
|
|
Várias linhas
|
multiline | boolean |
Multilinha. |
|
|
Tipo de segredo
|
secret_type | string |
Tipo de segredo. |
|
|
Format
|
format | string |
Formato. |
|
|
Versões máximas
|
max_versions | string |
Versões máximas. |
|
|
Excluir Proteção
|
delete_protection | boolean |
Excluir Proteção. |
Retornos
- response
- object
Descrever Item
Retorna metadados de um item por caminho ou id. Consulte describe-item.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Caminho do item
|
name | True | string |
Caminho completo (nome do item) no Akeyless, por exemplo |
|
Mostrar versões
|
show_versions | boolean |
Incluir versões de item na resposta (Akeyless |
Retornos
JSON de resposta de item de descrição do Akeyless.
- response
- object
Excluir item
Gravação: exclui ou agenda a exclusão. Consulte delete-item.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Name
|
name | True | string |
Nome. |
|
Excluir imediatamente
|
delete_immediately | boolean |
Exclua imediatamente. |
|
|
Excluir em dias
|
delete_in_days | integer |
Excluir em dias. |
|
|
Version
|
version | integer |
Version. |
Retornos
- response
- object
Itens da Lista
Lista pastas e itens em um caminho de cofre. Consulte itens de lista.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Caminho da pasta
|
path | string |
Caminho da pasta para listar (por exemplo |
|
|
Filtro de nome
|
filter | string |
Filtrar por nome de item ou subcadeia de caracteres. |
|
|
Token de paginação
|
pagination_token | string |
Token de paginação de uma resposta anterior. |
|
|
Somente pasta atual
|
current_folder | boolean |
Se for true, liste apenas os filhos diretos da pasta. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
items
|
items | array of object |
Itens no caminho solicitado. |
|
item_name
|
items.item_name | string |
Caminho do item. |
|
item_type
|
items.item_type | string |
Tipo de item sem chave. |
|
display_id
|
items.display_id | string |
ID de exibição. |
|
next_page
|
next_page | string |
Token para a próxima página de resultados. |
|
has_next
|
has_next | boolean |
True quando outra página está disponível. |
Lista USC
Lista segredos para um Conector de Segredos Universais. Consulte usc-list.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Nome da Usc
|
usc_name | True | string |
Nome do item do Conector de Segredos Universais no Akeyless (enviado como |
Retornos
- response
- object
Listar destinos
Lista os destinos de integração. Consulte list-targets.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Filter
|
filter | string |
Filtro. |
|
|
Token de paginação
|
pagination_token | string |
Token de paginação. |
|
|
Tipo
|
type | array of string |
Tipos de destino a serem incluídos; omita para todos. |
Retornos
- response
- object
Listar funções
Lista funções. Consulte list-roles.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Filter
|
filter | string |
Filtro. |
|
|
Token de paginação
|
pagination_token | string |
Mapeia para Akeyless |
Retornos
- response
- object
Listar gateways
Listar grupos
Lista grupos. Consulte grupos de listas.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Filter
|
filter | string |
Filtro de subcadeia de caracteres no nome do grupo. |
|
|
Token de paginação
|
pagination_token | string |
Mapeia para Akeyless |
Retornos
- response
- object
Listar métodos de autenticação
Lista os métodos de autenticação. Consulte list-auth-methods. Opcional type é uma matriz de tipos de método (por exemploapi_key, ). ldap
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Filter
|
filter | string |
Filtro de subcadeia de caracteres no nome do método de autenticação. |
|
|
Token de paginação
|
pagination_token | string |
Mapeia para Akeyless |
|
|
Tipo
|
type | array of string |
Restringir a esses tipos de método de autenticação; omita para todos. |
Retornos
- response
- object
Mover objetos
Gravação: move ou renomeia itens, métodos de autenticação ou funções. Consulte move-objects.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Caminho de origem
|
source_path | True | string |
Caminho de origem. |
|
Caminho de destino
|
target_path | True | string |
Caminho de destino. |
|
Tipo de objetos
|
objects_type | string |
Tipo de objetos. |
Retornos
- response
- object
Obtenção de destino
Retorna um destino por nome. Consulte target-get.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Name
|
name | True | string |
Nome exato do destino. |
|
Mostrar versões
|
show_versions | boolean |
Inclua todas as versões de destino ( |
Retornos
- response
- object
Obter dados de análise
Obter função
Retorna uma função por nome. Consulte get-role.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Name
|
name | True | string |
Nome exato da função. |
Retornos
- response
- object
Obter método de autenticação
Retorna um método de autenticação por nome. Consulte get-auth-method.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Name
|
name | True | string |
Nome exato do método de autenticação. |
Retornos
- response
- object
Obter Segredo
Recupera um valor secreto. Use a conexão para a ID de Acesso/Chave de Acesso; forneça apenas o caminho do segredo.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Nome do segredo
|
secret_name | True | string |
Caminho completo do segredo em Akeyless (por exemplo /Prod/DB/Password). |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Valor do segredo
|
SecretValue | string |
Valor do segredo de texto sem formatação. |
Obter senha
Recupera um segredo de estilo de nome de usuário/senha estruturado. Mesma conexão; forneça apenas o caminho do segredo.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Nome do segredo
|
secret_name | True | string |
Caminho completo do segredo em Akeyless. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Nome de usuário
|
username | string |
Nome de usuário quando o segredo é armazenado como credenciais. |
|
Password
|
password | string |
Senha quando o segredo é armazenado como credenciais. |
Obter tags
Retorna marcas para um caminho de item. Consulte get-tags.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Name
|
name | True | string |
Caminho completo do item. |
Retornos
- response
- object
Definições
objeto
Esse é o tipo 'object'.