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/
Email 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 SecretValue campo
  • Obter senha – retorna username e password campos 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

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 /update-item e/ou /update-secret-val como MCP). Consulte update-item e update-secret-val.

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 type é uma matriz de tipos de método (por exemploapi_key, ). ldap

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 /Prod/DB/creds.

Mostrar versões
show_versions boolean

Incluir versões de item na resposta (Akeyless show-versions).

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 / ou /Production). Deixe vazio para raiz.

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 usc-name).

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 pagination-token.

Retornos

response
object

Listar gateways

Lista gateways. Consulte list-gateways.

Retornos

response
object

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 pagination-token.

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 pagination-token.

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 (show-versions).

Retornos

response
object

Obter dados de análise

Retorna dados de análise/uso. Consulte get-analytics-data.

Retornos

response
object

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