Access Control Entries - Set Access Control Entries

Riferimento

Servizio:: Security

Versione API:: 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

Tipo: oauth2
Flow: accessCode
URL di autorizzazione: https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
URL token: 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

Ambiti

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

Esempio

Merge

Replace

Merge

Esempio di richiesta

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": {}
    }
  ]
}

Risposta di esempio

Codice di stato:: 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

Esempio di richiesta

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": {}
    }
  ]
}

Risposta di esempio

Codice di stato:: 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

Object

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

Object

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

Object

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

Object

Rappresenta un oggetto JSON.

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

Condividi tramite

Access Control Entries - Set Access Control Entries

Parametri dell'URI

Corpo della richiesta

Risposte

Sicurezza

oauth2

Ambiti

Esempio

Merge

Esempio di richiesta

Risposta di esempio

Replace

Esempio di richiesta

Risposta di esempio

Definizioni

AccessControlEntry

AceExtendedInformation

IdentityDescriptor

JObject

Risorse aggiuntive