Access Control Lists - Query

Odwołanie

Usługa:: Security

Wersja interfejsu API:: 7.1

Zwróć listę list kontroli dostępu dla określonej przestrzeni nazw zabezpieczeń i tokenu. Wszystkie listy ACL w przestrzeni nazw zabezpieczeń zostaną pobrane, jeśli nie podano parametrów opcjonalnych.

GET https://dev.azure.com/{organization}/_apis/accesscontrollists/{securityNamespaceId}?api-version=7.1

Z parametrami opcjonalnymi:

GET https://dev.azure.com/{organization}/_apis/accesscontrollists/{securityNamespaceId}?token={token}&descriptors={descriptors}&includeExtendedInfo={includeExtendedInfo}&recurse={recurse}&api-version=7.1

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
securityNamespaceId	path	True	string (uuid)	Identyfikator przestrzeni nazw zabezpieczeń.
organization	path		string	Nazwa organizacji usługi Azure DevOps.
api-version	query	True	string	Wersja interfejsu API do użycia. Należy ustawić wartość "7.1", aby używać tej wersji interfejsu API.
descriptors	query		string	Opcjonalny ciąg filtru zawierający listę deskryptorów tożsamości rozdzielonych znakami "", których wartości ACE powinny zostać pobrane. W przypadku pozostawienia wartości null cała lista ACL zostanie zwrócona.
includeExtendedInfo	query		boolean	Jeśli wartość true, wypełnij rozszerzone właściwości informacji dla wpisów kontroli dostępu zawartych na zwracanych listach.
recurse	query		boolean	Jeśli wartość true i jest to hierarchiczna przestrzeń nazw, zwróć podrzędne listy ACL określonego tokenu.
token	query		string	Token zabezpieczający

Odpowiedzi

Nazwa	Typ	Opis
200 OK	AccessControlList[]	operacja zakończona powodzeniem

Zabezpieczenia

accessToken

Osobisty token dostępu. Użyj dowolnej wartości dla nazwy użytkownika i tokenu jako hasła.

Typ: basic

Przykłady

All ACLs in a security namespace

Filter by descriptors

Filter by token

Include child ACLs

Include extended info properties

All ACLs in a security namespace

Przykładowe żądanie

HTTP

GET https://dev.azure.com/fabrikam/_apis/accesscontrollists/5a27515b-ccd7-42c9-84f1-54c998f03866?api-version=7.1

Przykładowa odpowiedź

Kod stanu:: 200

{
  "count": 5,
  "value": [
    {
      "inheritPermissions": true,
      "token": "1ba198c0-7a12-46ed-a96b-f4e77554c6d4",
      "acesDictionary": {
        "Microsoft.TeamFoundation.Identity;S-1-9-1551374245-1204400969-2402986413-2179408616-0-0-0-0-1": {
          "descriptor": "Microsoft.TeamFoundation.Identity;S-1-9-1551374245-1204400969-2402986413-2179408616-0-0-0-0-1",
          "allow": 31,
          "deny": 0
        },
        "Microsoft.TeamFoundation.Identity;S-1-9-1551374245-1204400969-2402986413-2179408616-0-0-0-0-2": {
          "descriptor": "Microsoft.TeamFoundation.Identity;S-1-9-1551374245-1204400969-2402986413-2179408616-0-0-0-0-2",
          "allow": 31,
          "deny": 0
        },
        "Microsoft.TeamFoundation.Identity;S-1-9-1551374245-1204400969-2402986413-2179408616-0-0-0-0-3": {
          "descriptor": "Microsoft.TeamFoundation.Identity;S-1-9-1551374245-1204400969-2402986413-2179408616-0-0-0-0-3",
          "allow": 1,
          "deny": 0
        }
      }
    },
    {
      "inheritPermissions": true,
      "token": "1ba198c0-7a12-46ed-a96b-f4e77554c6d4\\846cd9c3-56ba-4158-b6d2-23a3a73244e5",
      "acesDictionary": {
        "Microsoft.TeamFoundation.Identity;S-1-9-1551374245-1204400969-2402986413-2179408616-0-0-0-1-2": {
          "descriptor": "Microsoft.TeamFoundation.Identity;S-1-9-1551374245-1204400969-2402986413-2179408616-0-0-0-1-2",
          "allow": 8,
          "deny": 0
        }
      }
    },
    {
      "inheritPermissions": true,
      "token": "28b9bb88-a513-4115-9b5c-8be39ce1f1ba",
      "acesDictionary": {
        "Microsoft.TeamFoundation.Identity;S-1-9-1551374245-2294004008-329585985-2606533603-2632053178-0-0-0-0-1": {
          "descriptor": "Microsoft.TeamFoundation.Identity;S-1-9-1551374245-2294004008-329585985-2606533603-2632053178-0-0-0-0-1",
          "allow": 31,
          "deny": 0
        },
        "Microsoft.TeamFoundation.Identity;S-1-9-1551374245-2294004008-329585985-2606533603-2632053178-0-0-0-0-2": {
          "descriptor": "Microsoft.TeamFoundation.Identity;S-1-9-1551374245-2294004008-329585985-2606533603-2632053178-0-0-0-0-2",
          "allow": 31,
          "deny": 0
        },
        "Microsoft.TeamFoundation.Identity;S-1-9-1551374245-2294004008-329585985-2606533603-2632053178-0-0-0-0-3": {
          "descriptor": "Microsoft.TeamFoundation.Identity;S-1-9-1551374245-2294004008-329585985-2606533603-2632053178-0-0-0-0-3",
          "allow": 1,
          "deny": 0
        }
      }
    },
    {
      "inheritPermissions": false,
      "token": "token1",
      "acesDictionary": {
        "Microsoft.TeamFoundation.Identity;S-1-9-1551374245-1204400969-2402986413-2179408616-0-0-0-0-1": {
          "descriptor": "Microsoft.TeamFoundation.Identity;S-1-9-1551374245-1204400969-2402986413-2179408616-0-0-0-0-1",
          "allow": 31,
          "deny": 0
        }
      }
    },
    {
      "inheritPermissions": false,
      "token": "token2",
      "acesDictionary": {
        "Microsoft.TeamFoundation.Identity;S-1-9-1551374245-1204400969-2402986413-2179408616-0-0-0-0-1": {
          "descriptor": "Microsoft.TeamFoundation.Identity;S-1-9-1551374245-1204400969-2402986413-2179408616-0-0-0-0-1",
          "allow": 1,
          "deny": 0
        },
        "Microsoft.TeamFoundation.Identity;S-1-9-1551374245-1204400969-2402986413-2179408616-0-0-0-0-2": {
          "descriptor": "Microsoft.TeamFoundation.Identity;S-1-9-1551374245-1204400969-2402986413-2179408616-0-0-0-0-2",
          "allow": 8,
          "deny": 0
        }
      }
    }
  ]
}

Filter by descriptors

Przykładowe żądanie

HTTP

GET https://dev.azure.com/fabrikam/_apis/accesscontrollists/5a27515b-ccd7-42c9-84f1-54c998f03866?descriptors=Microsoft.TeamFoundation.Identity;S-1-9-1551374245-1204400969-2402986413-2179408616-0-0-0-0-1&api-version=7.1

Przykładowa odpowiedź

Kod stanu:: 200

{
  "count": 5,
  "value": [
    {
      "inheritPermissions": true,
      "token": "1ba198c0-7a12-46ed-a96b-f4e77554c6d4",
      "acesDictionary": {
        "Microsoft.TeamFoundation.Identity;S-1-9-1551374245-1204400969-2402986413-2179408616-0-0-0-0-1": {
          "descriptor": "Microsoft.TeamFoundation.Identity;S-1-9-1551374245-1204400969-2402986413-2179408616-0-0-0-0-1",
          "allow": 31,
          "deny": 0
        }
      }
    },
    {
      "inheritPermissions": true,
      "token": "1ba198c0-7a12-46ed-a96b-f4e77554c6d4\\846cd9c3-56ba-4158-b6d2-23a3a73244e5",
      "acesDictionary": {
        "Microsoft.TeamFoundation.Identity;S-1-9-1551374245-1204400969-2402986413-2179408616-0-0-0-0-1": {
          "descriptor": "Microsoft.TeamFoundation.Identity;S-1-9-1551374245-1204400969-2402986413-2179408616-0-0-0-0-1",
          "allow": 0,
          "deny": 0
        }
      }
    },
    {
      "inheritPermissions": true,
      "token": "28b9bb88-a513-4115-9b5c-8be39ce1f1ba",
      "acesDictionary": {
        "Microsoft.TeamFoundation.Identity;S-1-9-1551374245-1204400969-2402986413-2179408616-0-0-0-0-1": {
          "descriptor": "Microsoft.TeamFoundation.Identity;S-1-9-1551374245-1204400969-2402986413-2179408616-0-0-0-0-1",
          "allow": 0,
          "deny": 0
        }
      }
    },
    {
      "inheritPermissions": false,
      "token": "token1",
      "acesDictionary": {
        "Microsoft.TeamFoundation.Identity;S-1-9-1551374245-1204400969-2402986413-2179408616-0-0-0-0-1": {
          "descriptor": "Microsoft.TeamFoundation.Identity;S-1-9-1551374245-1204400969-2402986413-2179408616-0-0-0-0-1",
          "allow": 31,
          "deny": 0
        }
      }
    },
    {
      "inheritPermissions": false,
      "token": "token2",
      "acesDictionary": {
        "Microsoft.TeamFoundation.Identity;S-1-9-1551374245-1204400969-2402986413-2179408616-0-0-0-0-1": {
          "descriptor": "Microsoft.TeamFoundation.Identity;S-1-9-1551374245-1204400969-2402986413-2179408616-0-0-0-0-1",
          "allow": 1,
          "deny": 0
        }
      }
    }
  ]
}

Filter by token

Przykładowe żądanie

HTTP

GET https://dev.azure.com/fabrikam/_apis/accesscontrollists/5a27515b-ccd7-42c9-84f1-54c998f03866?token=1ba198c0-7a12-46ed-a96b-f4e77554c6d4&api-version=7.1

Przykładowa odpowiedź

Kod stanu:: 200

{
  "count": 1,
  "value": [
    {
      "inheritPermissions": true,
      "token": "1ba198c0-7a12-46ed-a96b-f4e77554c6d4",
      "acesDictionary": {
        "Microsoft.TeamFoundation.Identity;S-1-9-1551374245-1204400969-2402986413-2179408616-0-0-0-0-1": {
          "descriptor": "Microsoft.TeamFoundation.Identity;S-1-9-1551374245-1204400969-2402986413-2179408616-0-0-0-0-1",
          "allow": 31,
          "deny": 0
        },
        "Microsoft.TeamFoundation.Identity;S-1-9-1551374245-1204400969-2402986413-2179408616-0-0-0-0-2": {
          "descriptor": "Microsoft.TeamFoundation.Identity;S-1-9-1551374245-1204400969-2402986413-2179408616-0-0-0-0-2",
          "allow": 31,
          "deny": 0
        },
        "Microsoft.TeamFoundation.Identity;S-1-9-1551374245-1204400969-2402986413-2179408616-0-0-0-0-3": {
          "descriptor": "Microsoft.TeamFoundation.Identity;S-1-9-1551374245-1204400969-2402986413-2179408616-0-0-0-0-3",
          "allow": 1,
          "deny": 0
        }
      }
    }
  ]
}

Include child ACLs

Przykładowe żądanie

HTTP

GET https://dev.azure.com/fabrikam/_apis/accesscontrollists/5a27515b-ccd7-42c9-84f1-54c998f03866?token=1ba198c0-7a12-46ed-a96b-f4e77554c6d4&includeExtendedInfo=False&recurse=True&api-version=7.1

Przykładowa odpowiedź

Kod stanu:: 200

{
  "count": 2,
  "value": [
    {
      "inheritPermissions": true,
      "token": "1ba198c0-7a12-46ed-a96b-f4e77554c6d4",
      "acesDictionary": {
        "Microsoft.TeamFoundation.Identity;S-1-9-1551374245-1204400969-2402986413-2179408616-0-0-0-0-1": {
          "descriptor": "Microsoft.TeamFoundation.Identity;S-1-9-1551374245-1204400969-2402986413-2179408616-0-0-0-0-1",
          "allow": 31,
          "deny": 0
        },
        "Microsoft.TeamFoundation.Identity;S-1-9-1551374245-1204400969-2402986413-2179408616-0-0-0-0-2": {
          "descriptor": "Microsoft.TeamFoundation.Identity;S-1-9-1551374245-1204400969-2402986413-2179408616-0-0-0-0-2",
          "allow": 31,
          "deny": 0
        },
        "Microsoft.TeamFoundation.Identity;S-1-9-1551374245-1204400969-2402986413-2179408616-0-0-0-0-3": {
          "descriptor": "Microsoft.TeamFoundation.Identity;S-1-9-1551374245-1204400969-2402986413-2179408616-0-0-0-0-3",
          "allow": 1,
          "deny": 0
        }
      }
    },
    {
      "inheritPermissions": true,
      "token": "1ba198c0-7a12-46ed-a96b-f4e77554c6d4\\846cd9c3-56ba-4158-b6d2-23a3a73244e5",
      "acesDictionary": {
        "Microsoft.TeamFoundation.Identity;S-1-9-1551374245-1204400969-2402986413-2179408616-0-0-0-1-2": {
          "descriptor": "Microsoft.TeamFoundation.Identity;S-1-9-1551374245-1204400969-2402986413-2179408616-0-0-0-1-2",
          "allow": 8,
          "deny": 0
        }
      }
    }
  ]
}

Include extended info properties

Przykładowe żądanie

HTTP

GET https://dev.azure.com/fabrikam/_apis/accesscontrollists/5a27515b-ccd7-42c9-84f1-54c998f03866?token=1ba198c0-7a12-46ed-a96b-f4e77554c6d4&includeExtendedInfo=True&api-version=7.1

Przykładowa odpowiedź

Kod stanu:: 200

{
  "count": 1,
  "value": [
    {
      "inheritPermissions": true,
      "token": "1ba198c0-7a12-46ed-a96b-f4e77554c6d4",
      "acesDictionary": {
        "Microsoft.TeamFoundation.Identity;S-1-9-1551374245-1204400969-2402986413-2179408616-0-0-0-0-1": {
          "descriptor": "Microsoft.TeamFoundation.Identity;S-1-9-1551374245-1204400969-2402986413-2179408616-0-0-0-0-1",
          "allow": 31,
          "deny": 0,
          "extendedInfo": {
            "effectiveAllow": 31
          }
        },
        "Microsoft.TeamFoundation.Identity;S-1-9-1551374245-1204400969-2402986413-2179408616-0-0-0-0-2": {
          "descriptor": "Microsoft.TeamFoundation.Identity;S-1-9-1551374245-1204400969-2402986413-2179408616-0-0-0-0-2",
          "allow": 31,
          "deny": 0,
          "extendedInfo": {
            "effectiveAllow": 31
          }
        },
        "Microsoft.TeamFoundation.Identity;S-1-9-1551374245-1204400969-2402986413-2179408616-0-0-0-0-3": {
          "descriptor": "Microsoft.TeamFoundation.Identity;S-1-9-1551374245-1204400969-2402986413-2179408616-0-0-0-0-3",
          "allow": 1,
          "deny": 0,
          "extendedInfo": {
            "effectiveAllow": 1
          }
        }
      },
      "includeExtendedInfo": true
    }
  ]
}

Definicje

Nazwa	Opis
AccessControlEntry	Klasa hermetyzowania dozwolonych i odrzuconych uprawnień dla danej klasy IdentityDescriptor.
AccessControlList	Klasa AccessControlList jest przeznaczona do skojarzenia zestawu AccessControlEntries z tokenem zabezpieczającym i jego ustawieniami dziedziczenia.
AceExtendedInformation	Przechowuje dziedziczone i skuteczne informacje o uprawnieniach dla danego elementu AccessControlEntry.
IdentityDescriptor	Deskryptor tożsamości to otoka typu tożsamości (identyfikator SID systemu Windows, passport) wraz z unikatowym identyfikatorem, takim jak identyfikator SID lub PUID.

AccessControlEntry

Objekt

Klasa hermetyzowania dozwolonych i odrzuconych uprawnień dla danej klasy IdentityDescriptor.

Nazwa	Typ	Opis
allow	integer (int32)	Zestaw bitów uprawnień reprezentujących akcje, które mogą wykonywać skojarzony deskryptor.
deny	integer (int32)	Zestaw bitów uprawnień reprezentujących akcje, których skojarzony deskryptor nie może wykonać.
descriptor	IdentityDescriptor	Deskryptor dla użytkownika, do których ma zastosowanie ten element AccessControlEntry.
extendedInfo	AceExtendedInformation	Ta wartość, po ustawieniu, zgłasza dziedziczone i skuteczne informacje dla skojarzonego deskryptora. Ta wartość jest ustawiana tylko w parametrze AccessControlEntries zwracanym przez wywołanie QueryAccessControlList(s), gdy parametr includeExtendedInfo ma wartość true.

AccessControlList

Objekt

Klasa AccessControlList jest przeznaczona do skojarzenia zestawu AccessControlEntries z tokenem zabezpieczającym i jego ustawieniami dziedziczenia.

Nazwa	Typ	Opis
acesDictionary	<string, AccessControlEntry>	Magazyn uprawnień kluczem tożsamości, dla których jest uprawnienie.
includeExtendedInfo	boolean	Prawda, jeśli ta lista kontroli dostępu zawiera rozszerzone informacje.
inheritPermissions	boolean	Wartość True, jeśli dany token dziedziczy uprawnienia od elementów nadrzędnych.
token	string	Token, dla którego znajduje się ta lista AccessControlList.

AceExtendedInformation

Objekt

Przechowuje dziedziczone i skuteczne informacje o uprawnieniach dla danego elementu AccessControlEntry.

Nazwa	Typ	Opis
effectiveAllow	integer (int32)	Jest to kombinacja wszystkich jawnych i dziedziczonych uprawnień dla tej tożsamości na tym tokenie. Są to uprawnienia używane podczas określania, czy dany użytkownik ma uprawnienia do wykonania akcji.
effectiveDeny	integer (int32)	Jest to kombinacja wszystkich jawnych i dziedziczonych uprawnień dla tej tożsamości na tym tokenie. Są to uprawnienia używane podczas określania, czy dany użytkownik ma uprawnienia do wykonania akcji.
inheritedAllow	integer (int32)	Są to uprawnienia dziedziczone dla tej tożsamości na tym tokenie. Jeśli token nie dziedziczy uprawnień, będzie to 0. Należy pamiętać, że wszystkie uprawnienia jawnie ustawione na tym tokenie dla tej tożsamości lub wszystkie grupy, których ta tożsamość jest częścią, nie są uwzględnione w tym miejscu.
inheritedDeny	integer (int32)	Są to uprawnienia dziedziczone dla tej tożsamości na tym tokenie. Jeśli token nie dziedziczy uprawnień, będzie to 0. Należy pamiętać, że wszystkie uprawnienia jawnie ustawione na tym tokenie dla tej tożsamości lub wszystkie grupy, których ta tożsamość jest częścią, nie są uwzględnione w tym miejscu.

IdentityDescriptor

Objekt

Deskryptor tożsamości to otoka typu tożsamości (identyfikator SID systemu Windows, passport) wraz z unikatowym identyfikatorem, takim jak identyfikator SID lub PUID.

Nazwa	Typ	Opis
identifier	string	Unikatowy identyfikator tej tożsamości, który nie przekracza 256 znaków, które będą utrwalane.
identityType	string	Typ deskryptora (na przykład Windows, Passport itp.).

Udostępnij przez

Access Control Lists - Query

Parametry identyfikatora URI

Odpowiedzi

Zabezpieczenia

accessToken

Przykłady

All ACLs in a security namespace

Przykładowe żądanie

Przykładowa odpowiedź

Filter by descriptors

Przykładowe żądanie

Przykładowa odpowiedź

Filter by token

Przykładowe żądanie

Przykładowa odpowiedź

Include child ACLs

Przykładowe żądanie

Przykładowa odpowiedź

Include extended info properties

Przykładowe żądanie

Przykładowa odpowiedź

Definicje

AccessControlEntry

AccessControlList

AceExtendedInformation

IdentityDescriptor