Azure Confidential Ledger
Element ConfidentialLedgerClient zapisuje i pobiera wpisy rejestru względem usługi Poufne rejestry.
Ten łącznik jest dostępny w następujących produktach i regionach:
| Usługa | 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) |
| 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 | 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) |
| Kontakt | |
|---|---|
| Name | Zespół ds. poufnych rejestrów platformy Azure |
| accledgerdevs@microsoft.com |
| Metadane łącznika | |
|---|---|
| Publisher | Microsoft Corporation |
| Witryna internetowa | https://www.microsoft.com/en-us/microsoft-365 |
| Zasady ochrony prywatności | https://privacy.microsoft.com/ |
| Kategorie | Produktywność |
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.
Limity ograniczania
| Nazwa | Wywołania | Okres odnowienia |
|---|---|---|
| Wywołania interfejsu API na połączenie | 100 | 60 sekund |
Akcje
| Pobiera bieżący wpis rejestru |
Opcjonalnie można określić identyfikator kolekcji, aby wskazać kolekcję, z której ma zostać pobrana wartość. Aby zwrócić starsze wpisy rejestru, odpowiednie sekcje rejestru muszą być odczytywane z dysku i weryfikowane. Aby zapobiec blokowaniu w enklawie, odpowiedź będzie wskazywać, czy wpis jest gotowy, czy część odpowiedzi, czy też ładowanie jest nadal w toku. |
| Pobiera potwierdzenie według identyfikatora transakcji |
Zwraca potwierdzenie kryptograficzne, które może służyć do weryfikowania integralności transakcji. |
| Pobiera stan wpisu według identyfikatora transakcji |
Zwraca bieżący stan transakcji wskazujący, czy został zatwierdzony w rejestrze. |
| Pobiera wpis rejestru według identyfikatora transakcji |
Opcjonalnie można określić identyfikator kolekcji, aby wskazać kolekcję, z której ma zostać pobrana wartość. Aby zwrócić starsze wpisy rejestru, odpowiednie sekcje rejestru muszą być odczytywane z dysku i weryfikowane. Aby zapobiec blokowaniu w enklawie, odpowiedź będzie wskazywać, czy wpis jest gotowy, czy część odpowiedzi, czy też ładowanie jest nadal w toku. |
| Pobiera wpisy rejestru według kolekcji i zakresu |
Można opcjonalnie określić identyfikator kolekcji. Zostaną zwrócone tylko wpisy w określonej kolekcji (lub domyślnej). |
| Zapisuje wpis rejestru |
Można opcjonalnie określić identyfikator kolekcji. |
Pobiera bieżący wpis rejestru
Opcjonalnie można określić identyfikator kolekcji, aby wskazać kolekcję, z której ma zostać pobrana wartość. Aby zwrócić starsze wpisy rejestru, odpowiednie sekcje rejestru muszą być odczytywane z dysku i weryfikowane. Aby zapobiec blokowaniu w enklawie, odpowiedź będzie wskazywać, czy wpis jest gotowy, czy część odpowiedzi, czy też ładowanie jest nadal w toku.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Wersja interfejsu API do użycia z żądaniem HTTP.
|
api-version | True | string |
Wersja interfejsu API do użycia z żądaniem HTTP. |
|
Identyfikator kolekcji.
|
collectionId | string |
Identyfikator kolekcji. |
|
|
Nazwa rejestru.
|
ledgerName | True | string |
Nazwa rejestru. |
Zwraca
Wpis w rejestrze.
- Body
- LedgerEntry
Pobiera potwierdzenie według identyfikatora transakcji
Zwraca potwierdzenie kryptograficzne, które może służyć do weryfikowania integralności transakcji.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Wersja interfejsu API do użycia z żądaniem HTTP.
|
api-version | True | string |
Wersja interfejsu API do użycia z żądaniem HTTP. |
|
Identyfikuje transakcję zapisu.
|
transactionId | True | string |
Identyfikuje transakcję zapisu. |
|
Nazwa rejestru.
|
ledgerName | True | string |
Nazwa rejestru. |
Zwraca
Potwierdzenie certyfikowania transakcji o określonym identyfikatorze.
- Body
- TransactionReceipt
Pobiera stan wpisu według identyfikatora transakcji
Zwraca bieżący stan transakcji wskazujący, czy został zatwierdzony w rejestrze.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Wersja interfejsu API do użycia z żądaniem HTTP.
|
api-version | True | string |
Wersja interfejsu API do użycia z żądaniem HTTP. |
|
Identyfikuje transakcję zapisu.
|
transactionId | True | string |
Identyfikuje transakcję zapisu. |
|
Nazwa rejestru.
|
ledgerName | True | string |
Nazwa rejestru. |
Zwraca
Odpowiedź zwrócona do zapytania o stan transakcji
- Body
- TransactionStatus
Pobiera wpis rejestru według identyfikatora transakcji
Opcjonalnie można określić identyfikator kolekcji, aby wskazać kolekcję, z której ma zostać pobrana wartość. Aby zwrócić starsze wpisy rejestru, odpowiednie sekcje rejestru muszą być odczytywane z dysku i weryfikowane. Aby zapobiec blokowaniu w enklawie, odpowiedź będzie wskazywać, czy wpis jest gotowy, czy część odpowiedzi, czy też ładowanie jest nadal w toku.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Wersja interfejsu API do użycia z żądaniem HTTP.
|
api-version | True | string |
Wersja interfejsu API do użycia z żądaniem HTTP. |
|
Identyfikator kolekcji.
|
collectionId | string |
Identyfikator kolekcji. |
|
|
Identyfikuje transakcję zapisu.
|
transactionId | True | string |
Identyfikuje transakcję zapisu. |
|
Nazwa rejestru.
|
ledgerName | True | string |
Nazwa rejestru. |
Zwraca
Wynik zapytania dotyczącego wpisu rejestru ze starszego identyfikatora transakcji. Wpis rejestru jest dostępny w odpowiedzi tylko wtedy, gdy zwrócony stan to Gotowe.
- Body
- LedgerQueryResult
Pobiera wpisy rejestru według kolekcji i zakresu
Można opcjonalnie określić identyfikator kolekcji. Zostaną zwrócone tylko wpisy w określonej kolekcji (lub domyślnej).
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Wersja interfejsu API do użycia z żądaniem HTTP.
|
api-version | True | string |
Wersja interfejsu API do użycia z żądaniem HTTP. |
|
Identyfikator kolekcji.
|
collectionId | string |
Identyfikator kolekcji. |
|
|
Określ pierwszy identyfikator transakcji w zakresie.
|
fromTransactionId | string |
Określ pierwszy identyfikator transakcji w zakresie. |
|
|
Określ ostatni identyfikator transakcji w zakresie.
|
toTransactionId | string |
Określ ostatni identyfikator transakcji w zakresie. |
|
|
Nazwa rejestru.
|
ledgerName | True | string |
Nazwa rejestru. |
Zwraca
Wpisy rejestru podzielonego na strony zwrócone w odpowiedzi na zapytanie.
- Body
- PagedLedgerEntries
Zapisuje wpis rejestru
Można opcjonalnie określić identyfikator kolekcji.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Wersja interfejsu API do użycia z żądaniem HTTP.
|
api-version | True | string |
Wersja interfejsu API do użycia z żądaniem HTTP. |
|
Identyfikator kolekcji.
|
collectionId | string |
Identyfikator kolekcji. |
|
|
contents
|
contents | True | string |
Zawartość wpisu rejestru. |
|
collectionId
|
collectionId | string | ||
|
transactionId (identyfikator transakcji)
|
transactionId | string |
Identyfikator transakcji |
|
|
Nazwa rejestru.
|
ledgerName | True | string |
Nazwa rejestru. |
Zwraca
Zwrócony w wyniku zapisu w rejestrze poufnym identyfikator transakcji w odpowiedzi wskazuje, kiedy zapis stanie się trwały.
- Body
- LedgerWriteResult
Definicje
Rejestry
Tablica wpisów rejestru.
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Przedmioty
|
LedgerEntry |
Wpis w rejestrze. |
RejestrEntry
Wpis w rejestrze.
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
contents
|
contents | string |
Zawartość wpisu rejestru. |
|
collectionId
|
collectionId | string | |
|
transactionId (identyfikator transakcji)
|
transactionId | string |
Identyfikator transakcji |
LedgerQueryResult
Wynik zapytania dotyczącego wpisu rejestru ze starszego identyfikatora transakcji. Wpis rejestru jest dostępny w odpowiedzi tylko wtedy, gdy zwrócony stan to Gotowe.
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
stan
|
state | LedgerQueryState |
Stan zapytania rejestru. |
|
wpis
|
entry | LedgerEntry |
Wpis w rejestrze. |
LedgerQueryState
LedgerWriteResult
Zwrócony w wyniku zapisu w rejestrze poufnym identyfikator transakcji w odpowiedzi wskazuje, kiedy zapis stanie się trwały.
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
collectionId
|
collectionId | string |
PagedLedgerEntries
Wpisy rejestru podzielonego na strony zwrócone w odpowiedzi na zapytanie.
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
stan
|
state | LedgerQueryState |
Stan zapytania rejestru. |
|
nextLink
|
nextLink | string |
Ścieżka do pobrania następnej strony wyników. |
|
Wpisy
|
entries | LedgerEntries |
Tablica wpisów rejestru. |
TransactionId
Unikatowy identyfikator stanu rejestru. Jeśli zostanie zwrócona jako część rejestru, wskazuje stan, z którego odczytano wpis.
Unikatowy identyfikator stanu rejestru. Jeśli zostanie zwrócona jako część rejestru, wskazuje stan, z którego odczytano wpis.
TransactionReceipt
Potwierdzenie certyfikowania transakcji o określonym identyfikatorze.
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
applicationClaims
|
applicationClaims | ApplicationClaims |
Lista oświadczeń aplikacji. |
|
paragon
|
receipt | ReceiptContents | |
|
stan
|
state | LedgerQueryState |
Stan zapytania rejestru. |
|
transactionId (identyfikator transakcji)
|
transactionId | TransactionId |
Unikatowy identyfikator stanu rejestru. Jeśli zostanie zwrócona jako część rejestru, wskazuje stan, z którego odczytano wpis. |
TransactionState
TransactionStatus
Odpowiedź zwrócona do zapytania o stan transakcji
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
stan
|
state | TransactionState |
Reprezentuje stan transakcji. |
|
transactionId (identyfikator transakcji)
|
transactionId | TransactionId |
Unikatowy identyfikator stanu rejestru. Jeśli zostanie zwrócona jako część rejestru, wskazuje stan, z którego odczytano wpis. |
ApplicationClaims
Lista oświadczeń aplikacji.
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Przedmioty
|
ApplicationClaim |
Oświadczenie aplikacji rejestru. |
ApplicationClaim
Oświadczenie aplikacji rejestru.
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
skrót
|
digest | ClaimDigest |
Oświadczenie aplikacji w postaci szyfrowanej. |
|
rodzaj
|
kind | ApplicationClaimKind |
Reprezentuje rodzaj oświadczenia aplikacji. |
|
rejestrEntry
|
ledgerEntry | LedgerEntryClaim |
Oświadczenie aplikacji pochodzące z danych wpisu rejestru. |
ApplicationClaimKind
ApplicationClaimProtocol
Reprezentuje protokół używany do obliczania skrótu oświadczenia z danych oświadczeń.
Reprezentuje protokół używany do obliczania skrótu oświadczenia z danych oświadczeń.
ClaimDigest
Oświadczenie aplikacji w postaci szyfrowanej.
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
value
|
value | string |
Skrót oświadczenia aplikacji w postaci szesnastkowej. |
|
protokół
|
protocol | ApplicationClaimProtocol |
Reprezentuje protokół używany do obliczania skrótu oświadczenia z danych oświadczeń. |
LedgerEntryClaim
Oświadczenie aplikacji pochodzące z danych wpisu rejestru.
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
collectionId
|
collectionId | string |
Identyfikator kolekcji. |
|
contents
|
contents | string |
Zawartość wpisu rejestru. |
|
secretKey (klucz sekretu)
|
secretKey | string |
Klucz tajny zakodowany w formacie Base64. |
|
protokół
|
protocol | ApplicationClaimProtocol |
Reprezentuje protokół używany do obliczania skrótu oświadczenia z danych oświadczeń. |
Potwierdzeńkontencja
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
cert
|
cert | string | |
|
liść
|
leaf | string | |
|
leafComponents
|
leafComponents | ReceiptLeafComponents | |
|
nodeId
|
nodeId | string | |
|
dowód
|
proof | ReceiptElementArray | |
|
korzeń
|
root | string | |
|
serviceEndorsements
|
serviceEndorsements | PemArray | |
|
podpis
|
signature | string |
Element paragonu
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
lewo
|
left | string | |
|
Prawy
|
right | string |
ReceiptElementArray
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Przedmioty
|
ReceiptElement |
ReceiptLeafComponents
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
claimsDigest
|
claimsDigest | string | |
|
commitEvidence
|
commitEvidence | string | |
|
writeSetDigest
|
writeSetDigest | string |
Pem
PemArray
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Przedmioty
|
Pem |