Access Control Entries - Set Access Control Entries

Service:

Security

API Version:

6.0

Aggiungere o aggiornare gli ACL nell'elenco di controllo di accesso per il token specificato. Il corpo della richiesta contiene il token di destinazione, un elenco di AES e un parametro di merge facoltativo. Nel caso di una collisione (per descrittore di identità) con un ACE esistente nell'ACL, il parametro "merge" determina il comportamento. Se impostato, l'ACE esistente ha il relativo consenti e negare l'unione con l'autorizzazione e la negazione dell'ACE in ingresso. Se non viene impostato, l'ace esistente viene spostato.

POST https://dev.azure.com/{organization}/_apis/accesscontrolentries/{securityNamespaceId}?api-version=6.0

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
securityNamespaceId	path	True	string uuid	Identificatore dello spazio dei nomi di sicurezza.
organization	path		string	Nome dell'organizzazione di Azure DevOps.
api-version	query	True	string	Versione dell'API da usare. Questa opzione deve essere impostata su '6.0' per usare questa versione dell'API.

Corpo della richiesta

Nome	Tipo	Descrizione
item	string
type	string	Ottiene il tipo di nodo per questo JToken.

Risposte

Nome	Tipo	Descrizione
200 OK	AccessControlEntry[]	operazione riuscita

Sicurezza

oauth2

Type: oauth2
Flow: accessCode
Authorization URL: https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
Token URL: https://app.vssps.visualstudio.com/oauth2/token?client_assertion_type=urn:ietf:params:oauth:client-assertion-type:jwt-bearer&grant_type=urn:ietf:params:oauth:grant-type:jwt-bearer

Scopes

Nome	Descrizione
vso.security_manage	Concede la possibilità di leggere, scrivere e gestire le autorizzazioni di sicurezza.

Esempio

Merge

Replace

Merge

Sample Request

HTTP

POST https://dev.azure.com/fabrikam/_apis/accesscontrolentries/5a27515b-ccd7-42c9-84f1-54c998f03866?api-version=6.0

{
  "token": "newToken",
  "merge": true,
  "accessControlEntries": [
    {
      "descriptor": "Microsoft.TeamFoundation.Identity;S-1-9-1551374245-1204400969-2402986413-2179408616-0-0-0-0-2",
      "allow": 8,
      "deny": 0,
      "extendedinfo": {}
    }
  ]
}

Sample Response

Status code:

200

{
  "count": 1,
  "value": [
    {
      "descriptor": "Microsoft.TeamFoundation.Identity;S-1-9-1551374245-1204400969-2402986413-2179408616-0-0-0-0-2",
      "allow": 13,
      "deny": 0,
      "extendedInfo": {}
    }
  ]
}

Replace

Sample Request

HTTP

POST https://dev.azure.com/fabrikam/_apis/accesscontrolentries/5a27515b-ccd7-42c9-84f1-54c998f03866?api-version=6.0

{
  "token": "newToken",
  "merge": false,
  "accessControlEntries": [
    {
      "descriptor": "Microsoft.TeamFoundation.Identity;S-1-9-1551374245-1204400969-2402986413-2179408616-0-0-0-0-1",
      "allow": 8,
      "deny": 0,
      "extendedinfo": {}
    }
  ]
}

Sample Response

Status code:

200

{
  "count": 1,
  "value": [
    {
      "descriptor": "Microsoft.TeamFoundation.Identity;S-1-9-1551374245-1204400969-2402986413-2179408616-0-0-0-0-1",
      "allow": 8,
      "deny": 0,
      "extendedInfo": {}
    }
  ]
}

Definizioni

Nome	Descrizione
AccessControlEntry	Classe per incapsulare le autorizzazioni consentite e negate per un determinato IdentityDescriptor.
AceExtendedInformation	Contiene le informazioni di autorizzazione ereditate ed efficaci per un determinato AccessControlEntry.
IdentityDescriptor	Un descrittore Identity è un wrapper per il tipo di identità (Windows SID, Passport) insieme a un identificatore univoco, ad esempio SID o PUID.
JObject	Rappresenta un oggetto JSON.

AccessControlEntry

Classe per incapsulare le autorizzazioni consentite e negate per un determinato IdentityDescriptor.

Nome	Tipo	Descrizione
allow	integer	Set di bit di autorizzazione che rappresentano le azioni che il descrittore associato può eseguire.
deny	integer	Set di bit di autorizzazione che rappresentano le azioni che il descrittore associato non è consentito eseguire.
descriptor	IdentityDescriptor	Il descrittore per l'utente a cui si applica AccessControlEntry.
extendedInfo	AceExtendedInformation	Questo valore, se impostato, segnala le informazioni ereditate ed efficaci per il descrittore associato. Questo valore viene impostato solo sulle voci AccessControlEntries restituite dalla chiamata QueryAccessControlList(s) quando il parametro includeExtendedInfo è impostato su true.

AceExtendedInformation

Contiene le informazioni di autorizzazione ereditate ed efficaci per un determinato AccessControlEntry.

Nome	Tipo	Descrizione
effectiveAllow	integer	Questa è la combinazione di tutte le autorizzazioni esplicite e ereditate per questa identità su questo token. Queste sono le autorizzazioni usate per determinare se un determinato utente dispone dell'autorizzazione per eseguire un'azione.
effectiveDeny	integer	Questa è la combinazione di tutte le autorizzazioni esplicite e ereditate per questa identità su questo token. Queste sono le autorizzazioni usate per determinare se un determinato utente dispone dell'autorizzazione per eseguire un'azione.
inheritedAllow	integer	Queste sono le autorizzazioni ereditate per questa identità su questo token. Se il token non eredita le autorizzazioni, sarà 0. Si noti che tutte le autorizzazioni impostate in modo esplicito su questo token per questa identità o su tutti i gruppi che questa identità fa parte di, non sono incluse qui.
inheritedDeny	integer	Queste sono le autorizzazioni ereditate per questa identità su questo token. Se il token non eredita le autorizzazioni, sarà 0. Si noti che tutte le autorizzazioni impostate in modo esplicito su questo token per questa identità o su tutti i gruppi che questa identità fa parte di, non sono incluse qui.

IdentityDescriptor

Un descrittore Identity è un wrapper per il tipo di identità (Windows SID, Passport) insieme a un identificatore univoco, ad esempio SID o PUID.

Nome	Tipo	Descrizione
identifier	string	Identificatore univoco per questa identità, non superiore a 256 caratteri, che verranno mantenuti.
identityType	string	Tipo di descrittore (ad esempio, Windows, Passport e così via).

JObject

Rappresenta un oggetto JSON.

Nome	Tipo	Descrizione
item	string
type	string	Ottiene il tipo di nodo per questo JToken.