Partager via


Org Enablement - Get

Obtenir l’état actuel de Advanced Security pour l’organisation

GET https://advsec.dev.azure.com/{organization}/_apis/management/enablement?api-version=7.2-preview.1
GET https://advsec.dev.azure.com/{organization}/_apis/management/enablement?includeAllProperties={includeAllProperties}&api-version=7.2-preview.1

Paramètres URI

Nom Dans Obligatoire Type Description
organization
path True

string

Nom de l’organisation Azure DevOps.

api-version
query True

string

Version de l’API à utiliser. Cette valeur doit être définie sur « 7.2-preview.1 » pour utiliser cette version de l’API.

includeAllProperties
query

boolean

Quand la valeur est true, déterminez également si les envois sont bloqués s’ils contiennent des secrets

Réponses

Nom Type Description
200 OK

AdvSecEnablementSettings

opération réussie

Sécurité

oauth2

Type: oauth2
Flux: accessCode
URL d’autorisation: https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
URL du jeton: 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

Étendues

Nom Description
vso.advsec Accorde la possibilité de lire des alertes, des instances de résultats, des instances de résultat d’analyse

Définitions

Nom Description
AdvSecEnablementFeatures
AdvSecEnablementSettings
AdvSecEnablementStatus

AdvSecEnablementFeatures

Nom Type Description
codeQLEnabled

boolean

L’état d’activation CodeQL est défini sur False lorsqu’il est désactivé et True lorsqu’il est activé ; La valeur Null n’est jamais définie explicitement.

dependencyScanningEnabled

boolean

L’état d’activation de l’analyse des dépendances a la valeur False lorsqu’il est désactivé et True lorsqu’il est activé ; La valeur Null n’est jamais définie explicitement.
Si GHAzDO n’est pas déjà activé, le comportement dépend si GHAzDO doit être activé/désactivé. DependencyScanningEnabled n’affecte rien dans ce scénario.
Si GHAzDO doit être désactivé, la valeur de DependencyScanningEnabled n’a aucun effet.
La définition de l’état d’activation de l’analyse des dépendances n’est prise en charge que pour l’activation du dépôt et non pour l’activation de l’organisation ou du projet pour l’instant.

AdvSecEnablementSettings

Nom Type Description
enableOnCreate

boolean

Activez automatiquement Advanced Security sur les dépôts nouvellement créés.

reposEnablementStatus

AdvSecEnablementStatus[]

AdvSecEnablementStatus

Nom Type Description
advSecEnabled

boolean

L’état d’activation avancé de la sécurité a la valeur False lorsqu’il est désactivé et True lorsqu’il est activé ; La valeur Null n’est jamais définie explicitement.

advSecEnablementFeatures

AdvSecEnablementFeatures

Inclut des fonctionnalités supplémentaires qui peuvent être activées avec Advanced Security.

advSecEnablementLastChangedDate

string

La dernière fois que l’état de Advanced Security pour ce référentiel a été mis à jour

blockPushes

boolean

Lorsque la valeur est true, les envois (push) contenant des secrets sont bloqués.
Lorsque la valeur est false, les push sont analysés pour les secrets et ne sont pas bloqués.
Si includeAllProperties dans la requête a la valeur false, cette valeur est null.

projectId

string

repositoryId

string