Gestor de Segredos Sem Chaves (Pré-visualização)

Conector sem chave para api.akeyless.io: liste e descreve itens do cofre, leia valores secretos e administre funções, gateways, alvos e métodos de autenticação. Suporta escritas opcionais para criar ou atualizar segredos e mover objetos de acordo com o RBAC da sua conta. A ligação utiliza HTTP Basic com ID de Acesso e Chave de Acesso à API Akeyless. Consulte readme.md para configuração de credenciais e referências de API.

Este conector está disponível nos seguintes produtos e regiões:

Service Classe Regiões
Estúdio Copiloto Premium Todas as regiões Power Automate exceto as seguintes:
     - Governo dos EUA (CCG)
     - Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Aplicações Lógicas Standard Todas as regiões do Logic Apps , exceto as seguintes:
     - Regiões Azure Government
     - 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 (CCG)
     - 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 (CCG)
     - Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Contact
Name Akeyless
URL https://www.akeyless.io/
Email simon.f@akeyless.io
Metadados do conector
Publisher Akeyless
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/

Gestor de Segredos Sem Chaves

A Akeyless é uma plataforma de gestão de segredos. Este conector chama a API Akeyless REST em api.akeyless.io para que os criadores possam listar itens do vault, ler valores secretos, inspecionar funções e infraestruturas e, opcionalmente, criar, atualizar, eliminar ou mover itens de acordo com o papel da Chave API.

Publisher

Akeyless

Prerequisites

  • Uma conta Akeyless.
  • Um método de autenticação por Chave API (ID de Acesso e Chave de Acesso). Crie uma na Consola Sem Chaves → Administração Utilizadores e Métodos de Autenticação → API. A Chave de Acesso é mostrada uma vez; armazena-a de forma segura. Veja Autenticar com Chave API.
  • Um Papel de Acesso que concede apenas as capacidades de que cada fluxo necessita (RBAC).

Connection

A ligação utiliza autenticação HTTP Basic:

  • ID de Acesso Sem Chave (nome de utilizador do protocolo)
  • Chave de Acesso Sem Chave (palavra-passe do protocolo)

Não introduza uma palavra-passe de email ou consola da conta Microsoft. As credenciais são enviadas para Akeyless /auth com access-typeaccess_key. Os órgãos de ação não aceitam ID de Acesso nem Chave de Acesso.

Operações suportadas

Ações principais (importantes):

  • Itens de Lista — pastas e metadados de itens sob um caminho
  • Descrever o Item — metadados para o caminho de um item
  • Get Secret — devolve um SecretValue campo
  • Get Password — devolve username e password campos quando o segredo é armazenado como credenciais

Ações avançadas incluem listar métodos de autenticação, funções, gateways, alvos, grupos, segredos USC, tags, análises e operações de escrita (Criar Segredo, Atualizar Item, Eliminar Item, Mover Objetos). Restringa o papel da API Key antes de usar as escritas.

Problemas e limitações conhecidos

  • Os valores secretos devolvidos por Get Secret e Get Password aparecem nas saídas de flow run. Limite quem pode ver esses fluxos.
  • As operações de escrita alteram dados no Akeyless. Testa primeiro num sandbox.
  • A cor da marca é #0E4D45.

Suporte

A criar uma ligação

O conector suporta os seguintes tipos de autenticação:

Predefinição 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.

Esta conexão não é compartilhável. Se o aplicativo avançado for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.

Name Tipo Description Required
ID de Acesso Sem Chave securestring O seu ID de Acesso Sem Chave (autenticação da API Key). Este valor é enviado como o nome de utilizador HTTP Basic de autenticação — não é um nome de utilizador da Microsoft. True
Chave de Acesso Sem Chave securestring A sua Chave de Acesso Sem Chave (secreta). Este valor é enviado como a palavra-passe HTTP Basic de autenticação — não é a sua palavra-passe da Microsoft. True

Ações

Atualizar Item

Write: atualiza metadados do item e/ou valor estático do segredo (usos /update-item e/ou /update-secret-val semelhantes ao MCP). Veja update-item e update-secret-val.

Criar segredo

Write: cria um segredo estático. Ver criar segredo.

Descrever o Item

Devolve metadados de um item por path ou id. Ver describe-item.

Eliminar o item

Escrever: apagar ou agendar a eliminação. Ver eliminar item.

Itens da Lista

Lista pastas e itens sob um caminho de cofre. Ver itens da lista.

Lista da USC

Lista segredos para um Conector de Segredos Universais. Ver usc-list.

Lista de Métodos de Autenticação

Lista métodos de autenticação. Ver list-auth-métodos. Opcional type é um array de tipos de métodos (por exemplo api_key, ldap).

Listar alvos

Lista os objetivos de integração. Ver alvos de lista.

Listar gateways

Lista portais. Ver portais de lista.

Listar Grupos

Lista, grupos. Ver grupos de lista.

Mover Objetos

Escreve: move ou renomeia itens, métodos de autenticação ou papéis. Ver mover-objetos.

Método de Obtenção de Autorização

Devolve um método de autenticação pelo nome. Veja o método get-auth.

Obtenha a palavra-passe

Recupera um segredo estruturado ao estilo nome de utilizador/palavra-passe. Mesma ligação; fornecer apenas o caminho secreto.

Obtenha Dados de Análise

Dados analíticos de retornos / utilização. Veja get-analytics-data.

Obter Função

Devolve um papel pelo nome. Veja o papel de obtenção.

Obter segredo

Recupera um valor secreto. Use a ligação para o ID de Acesso / Chave de Acesso; forneça apenas o caminho secreto.

Obter tags

Etiquetas de devolução para um caminho de item. Vê as etiquetas de obtén.

Papéis de Lista

Lista os papéis. Ver listas de papéis.

Target Get

Devolve um alvo pelo nome. Ver alvo-obter.

Atualizar Item

Write: atualiza metadados do item e/ou valor estático do segredo (usos /update-item e/ou /update-secret-val semelhantes ao MCP). Veja update-item e update-secret-val.

Parâmetros

Nome Chave Obrigatório Tipo Descrição
Name
name True string

Caminho atual dos itens.

Novo Valor
new_value string

Novo valor secreto para segredos estáticos.

Manter Versão Anterior
keep_prev_version boolean

Mantém a versão anterior.

Description
description string

Description.

Novo nome
new_name string

Novo nome.

Adicionar Etiquetas
add_tags array of string

Adicionar etiquetas.

Remover Etiquetas
remove_tags array of string

Remover etiquetas.

Versões Max
max_versions string

Versões máximas.

Proteção contra Eliminação
delete_protection boolean

Apagar Proteção.

Devoluções

response
object

Criar segredo

Write: cria um segredo estático. Ver criar segredo.

Parâmetros

Nome Chave Obrigatório Tipo Descrição
Name
name True string

Caminho completo do novo segredo.

Value
value True string

Material secreto.

Description
description string

Description.

Etiquetas
tags array of string

Etiquetas.

Chave de Proteção
protection_key string

Chave de Proteção.

Multilinha
multiline boolean

Multilinha.

Tipo Secreto
secret_type string

Tipo Secreto.

Format
format string

Formato.

Versões Max
max_versions string

Versões máximas.

Proteção contra Eliminação
delete_protection boolean

Apagar Proteção.

Devoluções

response
object

Descrever o Item

Devolve metadados de um item por path ou id. Ver describe-item.

Parâmetros

Nome Chave Obrigatório Tipo Descrição
Caminho do item
name True string

Caminho completo (nome do item) em Akeyless, por /Prod/DB/credsexemplo.

Versões do programa
show_versions boolean

Inclua versões dos itens na resposta (Akeyless show-versions).

Devoluções

JSON de resposta de descrever item do Akeyless.

response
object

Eliminar o item

Escrever: apagar ou agendar a eliminação. Ver eliminar item.

Parâmetros

Nome Chave Obrigatório Tipo Descrição
Name
name True string

Name.

Apagar imediatamente
delete_immediately boolean

Apagar imediatamente.

Eliminar em Dias
delete_in_days integer

Apagar em Dias.

Version
version integer

Version.

Devoluções

response
object

Itens da Lista

Lista pastas e itens sob um caminho de cofre. Ver itens da lista.

Parâmetros

Nome Chave Obrigatório Tipo Descrição
Caminho da pasta
path string

Caminho da pasta para a lista (por exemplo / , ou /Production). Deixe vazio para a raiz.

Filtro de nome
filter string

Filtra por nome do item ou substring.

Ficha de paginação
pagination_token string

Token de paginação de uma resposta anterior.

Apenas a pasta atual
current_folder boolean

Se for verdade, liste apenas filhos diretos da pasta.

Devoluções

Nome Caminho Tipo Descrição
items
items array of object

Itens abaixo do 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

Display id.

next_page
next_page string

Ficha para a próxima página de resultados.

has_next
has_next boolean

É verdade quando há outra página disponível.

Lista da USC

Lista segredos para um Conector de Segredos Universais. Ver usc-list.

Parâmetros

Nome Chave Obrigatório Tipo Descrição
Nome USC
usc_name True string

Nome do item do Universal Secrets Connector em Akeyless (enviado como usc-name).

Devoluções

response
object

Lista de Métodos de Autenticação

Lista métodos de autenticação. Ver list-auth-métodos. Opcional type é um array de tipos de métodos (por exemplo api_key, ldap).

Parâmetros

Nome Chave Obrigatório Tipo Descrição
Filtrar
filter string

Filtro de substring no nome do método de autenticação.

Ficha de paginação
pagination_token string

Mapas para Akeyless pagination-token.

Tipo
type array of string

Restringir a estes tipos de métodos de autenticação; omitir para todos.

Devoluções

response
object

Listar alvos

Lista os objetivos de integração. Ver alvos de lista.

Parâmetros

Nome Chave Obrigatório Tipo Descrição
Filtrar
filter string

Filtro.

Ficha de paginação
pagination_token string

Ficha de Paginação.

Tipo
type array of string

Tipos de alvos a incluir; omitir para todos.

Devoluções

response
object

Listar gateways

Lista portais. Ver portais de lista.

Devoluções

response
object

Listar Grupos

Lista, grupos. Ver grupos de lista.

Parâmetros

Nome Chave Obrigatório Tipo Descrição
Filtrar
filter string

Filtro de substring no nome do grupo.

Ficha de paginação
pagination_token string

Mapas para Akeyless pagination-token.

Devoluções

response
object

Mover Objetos

Escreve: move ou renomeia itens, métodos de autenticação ou papéis. Ver mover-objetos.

Parâmetros

Nome Chave Obrigatório Tipo Descrição
Caminho de origem
source_path True string

Caminho da Fonte.

Caminho de destino
target_path True string

Caminho do Alvo.

Tipo de Objetos
objects_type string

Tipo de Objetos.

Devoluções

response
object

Método de Obtenção de Autorização

Devolve um método de autenticação pelo nome. Veja o método get-auth.

Parâmetros

Nome Chave Obrigatório Tipo Descrição
Name
name True string

Nome exato do método de autenticação.

Devoluções

response
object

Obtenha a palavra-passe

Recupera um segredo estruturado ao estilo nome de utilizador/palavra-passe. Mesma ligação; fornecer apenas o caminho secreto.

Parâmetros

Nome Chave Obrigatório Tipo Descrição
Nome secreto
secret_name True string

Caminho completo do segredo em Akeyless.

Devoluções

Nome Caminho Tipo Descrição
Nome de utilizador
username string

Nome de utilizador quando o segredo é armazenado como credenciais.

Password
password string

Palavra-passe quando o segredo está armazenado como credenciais.

Obtenha Dados de Análise

Dados analíticos de retornos / utilização. Veja get-analytics-data.

Devoluções

response
object

Obter Função

Devolve um papel pelo nome. Veja o papel de obtenção.

Parâmetros

Nome Chave Obrigatório Tipo Descrição
Name
name True string

Nome exato da função.

Devoluções

response
object

Obter segredo

Recupera um valor secreto. Use a ligação para o ID de Acesso / Chave de Acesso; forneça apenas o caminho secreto.

Parâmetros

Nome Chave Obrigatório Tipo Descrição
Nome secreto
secret_name True string

Caminho completo do segredo em Akeyless (por exemplo, /Prod/DB/Password).

Devoluções

Nome Caminho Tipo Descrição
Valor secreto
SecretValue string

Valor secreto em texto simples.

Obter tags

Etiquetas de devolução para um caminho de item. Vê as etiquetas de obtén.

Parâmetros

Nome Chave Obrigatório Tipo Descrição
Name
name True string

Caminho completo do item.

Devoluções

response
object

Papéis de Lista

Lista os papéis. Ver listas de papéis.

Parâmetros

Nome Chave Obrigatório Tipo Descrição
Filtrar
filter string

Filtro.

Ficha de paginação
pagination_token string

Mapas para Akeyless pagination-token.

Devoluções

response
object

Target Get

Devolve um alvo pelo nome. Ver alvo-obter.

Parâmetros

Nome Chave Obrigatório Tipo Descrição
Name
name True string

Nome exato do alvo.

Versões do Programa
show_versions boolean

Inclua todas as versões alvo (show-versions).

Devoluções

response
object

Definições

objecto

Este é o tipo 'objeto'.