다음을 통해 공유


Project Enablement - Get

프로젝트에 대한 고급 보안의 현재 상태 가져오기

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

URI 매개 변수

Name In(다음 안에) 필수 형식 Description
organization
path True

string

Azure DevOps 조직의 이름입니다.

project
path True

string

프로젝트 ID 또는 프로젝트 이름

api-version
query True

string

사용할 API의 버전입니다. 이 API 버전을 사용하려면 '7.2-preview.3'으로 설정해야 합니다.

includeAllProperties
query

boolean

true인 경우 푸시에 비밀이 포함되어 있는지 여부도 확인합니다.

응답

Name 형식 Description
200 OK

ProjectEnablementSettings

성공한 작업

보안

oauth2

형식: oauth2
Flow: accessCode
권한 부여 URL: https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
토큰 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

범위

Name Description
vso.advsec 경고, 결과 인스턴스, 분석 결과 인스턴스를 읽을 수 있는 기능을 부여합니다.

정의

Name Description
CodeSecurityFeatures
EnablementOnCreateSettings
ProjectEnablementSettings
RepoEnablementSettings
SecretProtectionFeatures

CodeSecurityFeatures

Name 형식 Description
codeQLEnabled

boolean

사용할 수 없는 경우 CodeQL 사용 상태가 False로 설정되고 사용하도록 설정된 경우 True로 설정됩니다. Null은 명시적으로 설정되지 않습니다.

codeSecurityChangedBy

string (uuid)

코드 보안의 사용 상태를 수정한 마지막 사용자의 VSID입니다.

codeSecurityEnabled

boolean

사용할 수 없는 경우 코드 보안 사용 상태가 False로 설정되고 사용하도록 설정된 경우 True로 설정됩니다. Null은 명시적으로 설정되지 않습니다.

codeSecurityEnablementLastChangedDate

string (date-time)

이 리포지토리의 코드 보안 상태가 마지막으로 업데이트된 시간

dependencyScanningInjectionEnabled

boolean

종속성 검사 삽입 사용 가능 상태는 사용하지 않도록 설정된 경우 False로 설정되고 사용하도록 설정된 경우 True로 설정됩니다. Null은 명시적으로 설정되지 않습니다.
Advanced Security가 아직 사용하도록 설정되지 않은 경우 고급 보안을 사용/사용하지 않도록 설정해야 하는지에 따라 동작이 달라집니다. DependencyScanningInjectionEnabled는 이 시나리오에서 아무 영향도 미치지 않습니다.
고급 보안을 사용하지 않도록 설정하면 DependencyScanningInjectionEnabled의 값이 적용되지 않습니다.

EnablementOnCreateSettings

Name 형식 Description
enableBlockPushesOnCreate

boolean

비밀 보호가 자동으로 사용하도록 설정된 경우 비밀이 포함된 푸시 차단을 자동으로 사용하도록 설정합니다. EnableSecretProtectionOnCreate가 true가 아니면 이 플래그는 무시됩니다.

enableCodeQLOnCreate

boolean

Code Security를 자동으로 사용하도록 설정하면 CodeQL을 자동으로 사용하도록 설정합니다. EnableCodeSecurityOnCreate가 true가 아니면 이 플래그는 무시됩니다.

enableCodeSecurityOnCreate

boolean

새로 만든 리포지토리에서 Code Security를 자동으로 사용하도록 설정합니다.

enableDependabotOnCreate

boolean

코드 보안이 자동으로 사용하도록 설정된 경우 Dependabot을 자동으로 사용하도록 설정합니다. EnableCodeSecurityOnCreate가 true가 아니면 이 플래그는 무시됩니다.

enableDependencyScanningInjectionOnCreate

boolean

코드 보안이 자동으로 사용하도록 설정된 경우 종속성 검사 삽입을 자동으로 사용하도록 설정합니다. EnableCodeSecurityOnCreate가 true가 아니면 이 플래그는 무시됩니다.

enableSecretProtectionOnCreate

boolean

새로 만든 리포지토리에서 비밀 보호를 자동으로 사용하도록 설정합니다.

ProjectEnablementSettings

Name 형식 Description
codeSecurityFeatures

CodeSecurityFeatures

사용할 수 있는 코드 보안 기능을 포함합니다.

enablementOnCreateSettings

EnablementOnCreateSettings

새로 만든 리포지토리에 대한 자동 사용 설정입니다.

reposEnablementStatus

RepoEnablementSettings[]

지정된 조직 또는 프로젝트 내의 리포지토리에 대한 사용 상태 목록입니다.

secretProtectionFeatures

SecretProtectionFeatures

사용할 수 있는 비밀 보호 기능이 포함되어 있습니다.

RepoEnablementSettings

Name 형식 Description
codeSecurityFeatures

CodeSecurityFeatures

사용할 수 있는 코드 보안 기능을 포함합니다.

projectId

string (uuid)

프로젝트 ID

repositoryId

string (uuid)

리포지토리 ID

secretProtectionFeatures

SecretProtectionFeatures

사용할 수 있는 비밀 보호 기능을 포함합니다.

SecretProtectionFeatures

Name 형식 Description
blockPushes

boolean

true이면 비밀을 포함하는 푸시가 차단됩니다.
false이면 푸시에서 비밀을 검색하고 차단되지 않습니다.
요청에 includeAllProperties가 false이면 이 값은 null이 됩니다.

secretProtectionChangedBy

string (uuid)

비밀 보호의 사용 상태를 수정한 마지막 사용자의 VSID입니다.

secretProtectionEnabled

boolean

비활성 상태인 경우 비밀 보호 사용 상태가 False로 설정되고 사용하도록 설정된 경우 True로 설정됩니다. Null은 명시적으로 설정되지 않습니다.

secretProtectionEnablementLastChangedDate

string (date-time)

이 리포지토리에 대한 비밀 보호의 상태가 마지막으로 업데이트된 시간