Akeyless Secrets Manager (wersja zapoznawcza)

Łącznik Akeyless dla api.akeyless.io: wyświetlanie listy i opisywanie elementów magazynu, odczytywanie wartości wpisów tajnych i administrowanie rolami, bramami, obiektami docelowymi i metodami uwierzytelniania. Obsługuje opcjonalne operacje zapisu w celu tworzenia lub aktualizowania wpisów tajnych oraz przenoszenia obiektów na konto RBAC. Połączenie korzysta z protokołu HTTP Basic z identyfikatorem dostępu klucza interfejsu API bezkluczowego i kluczem dostępu. Zobacz readme.md, aby uzyskać informacje o konfiguracji poświadczeń i dokumentacji interfejsu API.

Ten łącznik jest dostępny w następujących produktach i regionach:

Service Class Regions
Copilot Studio Premium Wszystkie regiony usługi Power Automate z wyjątkiem następujących:
     - Rząd USA (GCC)
     - Rząd USA (GCC High)
     - China Cloud obsługiwane przez firmę 21Vianet
     - Departament Obrony USA (DoD)
Logic Apps Standard Wszystkie regiony usługi Logic Apps z wyjątkiem następujących:
     — Regiony platformy Azure Government
     — Regiony platformy Azure (Chiny)
     - Departament Obrony USA (DoD)
Power Apps Premium Wszystkie regiony usługi Power Apps z wyjątkiem następujących:
     - Rząd USA (GCC)
     - Rząd USA (GCC High)
     - China Cloud obsługiwane przez firmę 21Vianet
     - Departament Obrony USA (DoD)
Power Automate - narzędzie do automatyzacji procesów Premium Wszystkie regiony usługi Power Automate z wyjątkiem następujących:
     - Rząd USA (GCC)
     - Rząd USA (GCC High)
     - China Cloud obsługiwane przez firmę 21Vianet
     - Departament Obrony USA (DoD)
Contact
Name Akeyless
adres URL https://www.akeyless.io/
Email simon.f@akeyless.io
Metadane łącznika
Publisher Akeyless
Website https://www.akeyless.io/
Zasady ochrony prywatności https://www.akeyless.io/privacy-policy
Categories Zabezpieczenia;operacje IT
Support https://www.akeyless.io/support/

Akeyless Secrets Manager

Akeyless to platforma zarządzania wpisami tajnymi. Ten łącznik wywołuje bezkluczowy interfejs API REST, api.akeyless.io aby twórcy mogli wyświetlać listę elementów magazynu, odczytywać wartości wpisów tajnych, sprawdzać role i infrastrukturę oraz opcjonalnie tworzyć, aktualizować, usuwać lub przenosić elementy zgodnie z rolą Klucz interfejsu API.

Publisher

Akeyless

Prerequisites

  • Konto bez klucza.
  • Metoda uwierzytelniania klucza interfejsu API (identyfikator dostępu i klucz dostępu). Utwórz je w konsoli Akeyless w obszarze Administracja → użytkownicy i metody uwierzytelniania → klucz interfejsu API. Klucz dostępu jest wyświetlany raz; przechowywać je bezpiecznie. Zobacz Uwierzytelnianie przy użyciu klucza interfejsu API.
  • Rola dostępu, która przyznaje tylko możliwości, których potrzebuje każdy przepływ (RBAC).

Connection

Połączenie korzysta z uwierzytelniania podstawowego HTTP:

  • Akeyless Access ID (nazwa użytkownika protokołu)
  • Klucz dostępu bez klucza dostępu (hasło protokołu)

Nie należy wprowadzać konto Microsoft wiadomości e-mail ani hasła konsoli. Poświadczenia są wysyłane do usługi Akeyless /auth za pomocą polecenia access-typeaccess_key. Jednostki akcji nie akceptują identyfikatora dostępu ani klucza dostępu.

Obsługiwane operacje

Akcje podstawowe (ważne):

  • Elementy listy — foldery i metadane elementów w ścieżce
  • Opisywanie elementu — metadane dla jednej ścieżki elementu
  • Uzyskiwanie wpisu tajnegoSecretValue — zwraca pole
  • Pobieranie hasła — zwraca username i password pola, gdy wpis tajny jest przechowywany jako poświadczenia

Zaawansowane akcje obejmują wyświetlanie listy metod uwierzytelniania, ról, bram, obiektów docelowych, grup, wpisów tajnych USC, tagów, analiz i operacji zapisu (tworzenie wpisów tajnych, aktualizowanie elementu, usuwanie elementu, przenoszenie obiektów). Przed użyciem operacji zapisu ogranicz rolę klucza interfejsu API.

Znane problemy i ograniczenia

  • Wartości wpisów tajnych zwracane przez polecenie Pobierz wpis tajny i Pobierz hasło są wyświetlane w danych wyjściowych przebiegu przepływu. Ogranicz, kto może wyświetlać te przepływy.
  • Operacje zapisu zmieniają dane w usłudze Akeyless. Najpierw przetestuj w piaskownicy.
  • Kolor marki to #0E4D45.

Support

Tworzenie połączenia

Łącznik obsługuje następujące typy uwierzytelniania:
Wartość domyślna Parametry tworzenia połączenia. Wszystkie regiony Nie można udostępniać

Domyślny

Dotyczy: wszystkie regiony

Parametry tworzenia połączenia.

Nie jest to możliwe do udostępnienia połączenie. Jeśli aplikacja power zostanie udostępniona innemu użytkownikowi, zostanie wyświetlony monit o jawne utworzenie nowego połączenia.

Name Typ Opis Required
Akeyless Access ID securestring Twój identyfikator dostępu bez klucza Akeyless (auth klucza interfejsu API). Ta wartość jest wysyłana jako nazwa użytkownika uwierzytelniania podstawowego HTTP — nie jest to nazwa użytkownika Microsoft. True
Bezkluczowy klucz dostępu securestring Klucz dostępu bez klucza dostępu (klucz tajny). Ta wartość jest wysyłana jako hasło uwierzytelniania podstawowego HTTP — nie jest to hasło Microsoft. True

Akcje

Aktualizuj element

Zapis: aktualizuje metadane elementu i/lub statyczną wartość wpisu tajnego (używa /update-item i/lub /update-secret-val na przykład MCP). Zobacz update-item i update-secret-val.
Elementy listy

Wyświetla listę folderów i elementów w ścieżce magazynu. Zobacz listę-elementy.
Get Auth, metoda

Zwraca jedną metodę uwierzytelniania według nazwy. Zobacz get-auth-method.
Lista grup

Wyświetla listę grup. Zobacz list-groups.
Lista metod uwierzytelniania

Wyświetla listę metod uwierzytelniania. Zobacz list-auth-methods (Metody uwierzytelniania listy). Opcjonalny type to tablica typów metod (na przykład api_key). ldap
Lista USC

Wyświetla listę wpisów tajnych dla łącznika uniwersalnych wpisów tajnych. Zobacz usc-list.
Opisywanie elementu

Zwraca metadane elementu według ścieżki lub identyfikatora. Zobacz opis-element.
Pobieranie danych analitycznych

Zwraca dane analizy/użycia. Zobacz get-analytics-data.
Pobieranie elementu docelowego

Zwraca jeden element docelowy według nazwy. Zobacz target-get.
Pobierz tagi

Zwraca tagi dla ścieżki elementu. Zobacz get-tags.
Przenoszenie obiektów

Zapis: przenosi lub zmienia nazwy elementów, metod uwierzytelniania lub ról. Zobacz move-objects (Obiekty przenoszenia).
Usuwanie elementu

Zapis: usuwa lub planuje usunięcie. Zobacz usuwanie elementu.
Utwórz wpis tajny

Zapis: tworzy statyczny wpis tajny. Zobacz tworzenie wpisu tajnego.
Uzyskiwanie hasła

Pobiera ustrukturyzowany wpis tajny stylu nazwy użytkownika/hasła. To samo połączenie; podaj tylko ścieżkę wpisu tajnego.
Uzyskiwanie roli

Zwraca jedną rolę według nazwy. Zobacz get-role.
Wyświetl elementy docelowe

Wyświetla listę obiektów docelowych integracji. Zobacz list-targets (Miejsca docelowe listy).
Wyświetl listę bram

Wyświetla listę bram. Zobacz list-gateways (Bramy listy).
Wyświetlanie listy ról

Wyświetla listę ról. Zobacz list-roles (Role listy).
Zdobądź tajne informacje

Pobiera wartość wpisu tajnego. Użyj połączenia dla identyfikatora dostępu/klucza dostępu; podaj tylko ścieżkę wpisu tajnego.

Aktualizuj element

Identyfikator operacji:
UpdateItem

Zapis: aktualizuje metadane elementu i/lub statyczną wartość wpisu tajnego (używa /update-item i/lub /update-secret-val na przykład MCP). Zobacz update-item i update-secret-val.

Parametry

Nazwisko Klucz Wymagane Typ Opis
Name
 name True string

Bieżąca ścieżka elementu.
Nowa wartość
 new_value string

Nowa wartość wpisu tajnego dla statycznych wpisów tajnych.
Zachowaj wersję wstępną
 keep_prev_version boolean

Zachowaj wersję wstępną.
Opis
 description string

Description.
Nowa nazwa
 new_name string

Nowa nazwa.
Dodawanie tagów
 add_tags array of string

Dodaj tagi.
Usuń tagi
 remove_tags array of string

Usuń tagi.
Maksymalna liczba wersji
 max_versions string

Maksymalna liczba wersji.
Usuwanie ochrony
 delete_protection boolean

Usuń ochronę.

Zwraca

response
object

Elementy listy

Identyfikator operacji:
ListItems

Wyświetla listę folderów i elementów w ścieżce magazynu. Zobacz listę-elementy.

Parametry

Nazwisko Klucz Wymagane Typ Opis
Ścieżka folderu
 path string

Ścieżka folderu do listy (na przykład / lub /Production). Pozostaw wartość pustą dla katalogu głównego.
Filtr nazw
 filter string

Filtruj według nazwy elementu lub podciągów.
Token stronicowania
 pagination_token string

Token stronicowania z poprzedniej odpowiedzi.
Tylko bieżący folder
 current_folder boolean

Jeśli wartość true, wyświetl tylko elementy podrzędne folderu.

Zwraca

Nazwisko Ścieżka Typ Opis
items
 items array of object

Elementy w żądanej ścieżce.
item_name
 items.item_name string

Ścieżka elementu.
item_type
 items.item_type string

Typ elementu bez klucza.
display_id
 items.display_id string

Identyfikator wyświetlania.
next_page
 next_page string

Token dla następnej strony wyników.
has_next
 has_next boolean

Wartość true, gdy jest dostępna inna strona.

Get Auth, metoda

Identyfikator operacji:
GetAuthMethod

Zwraca jedną metodę uwierzytelniania według nazwy. Zobacz get-auth-method.

Parametry

Nazwisko Klucz Wymagane Typ Opis
Name
 name True string

Dokładna nazwa metody uwierzytelniania.

Zwraca

response
object

Lista grup

Identyfikator operacji:
ListGroups

Wyświetla listę grup. Zobacz list-groups.

Parametry

Nazwisko Klucz Wymagane Typ Opis
Filter
 filter string

Filtr podciągów w nazwie grupy.
Token stronicowania
 pagination_token string

Mapuje na Akeyless pagination-token.

Zwraca

response
object

Lista metod uwierzytelniania

Identyfikator operacji:
ListAuthMethods

Wyświetla listę metod uwierzytelniania. Zobacz list-auth-methods (Metody uwierzytelniania listy). Opcjonalny type to tablica typów metod (na przykład api_key). ldap

Parametry

Nazwisko Klucz Wymagane Typ Opis
Filter
 filter string

Filtr podciągów w nazwie metody uwierzytelniania.
Token stronicowania
 pagination_token string

Mapuje na Akeyless pagination-token.
Typ
 type array of string

Ogranicz do tych typów metod uwierzytelniania; pominąć dla wszystkich.

Zwraca

response
object

Lista USC

Identyfikator operacji:
UscList

Wyświetla listę wpisów tajnych dla łącznika uniwersalnych wpisów tajnych. Zobacz usc-list.

Parametry

Nazwisko Klucz Wymagane Typ Opis
Nazwa usc
 usc_name True string

Nazwa elementu łącznika universal secrets w usłudze Akeyless (wysłana jako usc-name).

Zwraca

response
object

Opisywanie elementu

Identyfikator operacji:
DescribeItem

Zwraca metadane elementu według ścieżki lub identyfikatora. Zobacz opis-element.

Parametry

Nazwisko Klucz Wymagane Typ Opis
Ścieżka elementu
 name True string

Pełna ścieżka (nazwa elementu) w Akeyless, na przykład /Prod/DB/creds.
Pokaż wersje
 show_versions boolean

Uwzględnij wersje elementów w odpowiedzi (Akeyless show-versions).

Zwraca

Kod JSON odpowiedzi JSON z Akeyless.

response
object

Pobieranie danych analitycznych

Identyfikator operacji:
GetAnalyticsData

Zwraca dane analizy/użycia. Zobacz get-analytics-data.

Zwraca

response
object

Pobieranie elementu docelowego

Identyfikator operacji:
TargetGet

Zwraca jeden element docelowy według nazwy. Zobacz target-get.

Parametry

Nazwisko Klucz Wymagane Typ Opis
Name
 name True string

Dokładna nazwa docelowa.
Pokaż wersje
 show_versions boolean

Uwzględnij wszystkie wersje docelowe (show-versions).

Zwraca

response
object

Pobierz tagi

Identyfikator operacji:
GetTags

Zwraca tagi dla ścieżki elementu. Zobacz get-tags.

Parametry

Nazwisko Klucz Wymagane Typ Opis
Name
 name True string

Pełna ścieżka elementu.

Zwraca

response
object

Przenoszenie obiektów

Identyfikator operacji:
MoveObjects

Zapis: przenosi lub zmienia nazwy elementów, metod uwierzytelniania lub ról. Zobacz move-objects (Obiekty przenoszenia).

Parametry

Nazwisko Klucz Wymagane Typ Opis
Ścieżka źródłowa
 source_path True string

Ścieżka źródłowa.
Ścieżka docelowa
 target_path True string

Ścieżka docelowa.
Typ obiektów
 objects_type string

Typ obiektów.

Zwraca

response
object

Usuwanie elementu

Identyfikator operacji:
DeleteItem

Zapis: usuwa lub planuje usunięcie. Zobacz usuwanie elementu.

Parametry

Nazwisko Klucz Wymagane Typ Opis
Name
 name True string

Name.
Usuń natychmiast
 delete_immediately boolean

Usuń natychmiast.
Usuń w dniach
 delete_in_days integer

Usuń w dniach.
Version
 version integer

Version.

Zwraca

response
object

Utwórz wpis tajny

Identyfikator operacji:
CreateSecret

Zapis: tworzy statyczny wpis tajny. Zobacz tworzenie wpisu tajnego.

Parametry

Nazwisko Klucz Wymagane Typ Opis
Name
 name True string

Pełna ścieżka nowego wpisu tajnego.
Value
 value True string

Tajny materiał.
Opis
 description string

Description.
Etykiety
 tags array of string

Tagi.
Klucz ochrony
 protection_key string

Klucz ochrony.
Wieloliniowy
 multiline boolean

Wielowierszowy.
Typ wpisu tajnego
 secret_type string

Typ wpisu tajnego.
Forma
 format string

Format.
Maksymalna liczba wersji
 max_versions string

Maksymalna liczba wersji.
Usuwanie ochrony
 delete_protection boolean

Usuń ochronę.

Zwraca

response
object

Uzyskiwanie hasła

Identyfikator operacji:
GetPassword

Pobiera ustrukturyzowany wpis tajny stylu nazwy użytkownika/hasła. To samo połączenie; podaj tylko ścieżkę wpisu tajnego.

Parametry

Nazwisko Klucz Wymagane Typ Opis
Tajna nazwa
 secret_name True string

Pełna ścieżka wpisu tajnego w Akeyless.

Zwraca

Nazwisko Ścieżka Typ Opis
Nazwa użytkownika
 username string

Nazwa użytkownika, gdy wpis tajny jest przechowywany jako poświadczenia.
Password
 password string

Hasło, gdy wpis tajny jest przechowywany jako poświadczenia.

Uzyskiwanie roli

Identyfikator operacji:
GetRole

Zwraca jedną rolę według nazwy. Zobacz get-role.

Parametry

Nazwisko Klucz Wymagane Typ Opis
Name
 name True string

Dokładna nazwa roli.

Zwraca

response
object

Wyświetl elementy docelowe

Identyfikator operacji:
ListTargets

Wyświetla listę obiektów docelowych integracji. Zobacz list-targets (Miejsca docelowe listy).

Parametry

Nazwisko Klucz Wymagane Typ Opis
Filter
 filter string

Filtr.
Token stronicowania
 pagination_token string

Token stronicowania.
Typ
 type array of string

Typy docelowe do uwzględnienia; pominąć dla wszystkich.

Zwraca

response
object

Wyświetl listę bram

Identyfikator operacji:
ListGateways

Wyświetla listę bram. Zobacz list-gateways (Bramy listy).

Zwraca

response
object

Wyświetlanie listy ról

Identyfikator operacji:
ListRoles

Wyświetla listę ról. Zobacz list-roles (Role listy).

Parametry

Nazwisko Klucz Wymagane Typ Opis
Filter
 filter string

Filtr.
Token stronicowania
 pagination_token string

Mapuje na Akeyless pagination-token.

Zwraca

response
object

Zdobądź tajne informacje

Identyfikator operacji:
GetSecret

Pobiera wartość wpisu tajnego. Użyj połączenia dla identyfikatora dostępu/klucza dostępu; podaj tylko ścieżkę wpisu tajnego.

Parametry

Nazwisko Klucz Wymagane Typ Opis
Tajna nazwa
 secret_name True string

Pełna ścieżka wpisu tajnego w usłudze Akeyless (na przykład /Prod/DB/Password).

Zwraca

Nazwisko Ścieżka Typ Opis
Tajna wartość
 SecretValue string

Wartość wpisu tajnego w postaci zwykłego tekstu.

Definicje

obiekt

Jest to typ 'obiekt'.