Org Enablement - Update
組織のセキュリティ強化の状態を更新する
PATCH https://advsec.dev.azure.com/{organization}/_apis/management/enablement?api-version=7.2-preview.3
URI パラメーター
| 名前 | / | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
organization
|
path | True |
string |
Azure DevOps 組織の名前。 |
|
api-version
|
query | True |
string |
使用する API のバージョン。 このバージョンの API を使用するには、これを '7.2-preview.3' に設定する必要があります。 |
要求本文
| 名前 | 型 | 説明 |
|---|---|---|
| codeSecurityFeatures |
有効にできるコード セキュリティ機能が含まれています。 |
|
| enablementOnCreateSettings |
新しく作成されたリポジトリの自動有効化設定。 |
|
| reposEnablementStatus |
指定した組織内またはプロジェクト内のリポジトリの有効化状態の一覧。 |
|
| secretProtectionFeatures |
有効にできるシークレット保護機能が含まれています。 |
応答
| 名前 | 型 | 説明 |
|---|---|---|
| 200 OK |
成功した操作 |
セキュリティ
oauth2
型:
oauth2
フロー:
accessCode
Authorization URL (承認 URL):
https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
Token URL (トークン 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
スコープ
| 名前 | 説明 |
|---|---|
| vso.advsec_manage | sarif アップロード情報へのアクセス、分析の削除、アラートの更新を行う機能を付与します |
定義
| 名前 | 説明 |
|---|---|
|
Code |
|
|
Enablement |
|
|
Org |
|
|
Repo |
|
|
Secret |
CodeSecurityFeatures
| 名前 | 型 | 説明 |
|---|---|---|
| codeQLEnabled |
boolean |
CodeQL 有効化状態が無効の場合は False に設定され、有効な場合は True に設定されます。Null が明示的に設定されることはありません。 |
| codeSecurityChangedBy |
string (uuid) |
Code Security の有効化状態を変更した最後のユーザーの VSID。 |
| codeSecurityEnabled |
boolean |
Code Security enablement status set to False when disabled and True when enabled;Null が明示的に設定されることはありません。 |
| codeSecurityEnablementLastChangedDate |
string (date-time) |
このリポジトリのコード セキュリティの状態が最後に更新された時刻 |
| dependencyScanningInjectionEnabled |
boolean |
依存関係スキャン挿入の有効化状態が無効の場合は False に、有効な場合は True に設定されます。Null が明示的に設定されることはありません。 |
EnablementOnCreateSettings
| 名前 | 型 | 説明 |
|---|---|---|
| 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 |
新しく作成されたリポジトリで Secret Protection を自動的に有効にします。 |
OrgEnablementSettings
| 名前 | 型 | 説明 |
|---|---|---|
| codeSecurityFeatures |
有効にできるコード セキュリティ機能が含まれています。 |
|
| enablementOnCreateSettings |
新しく作成されたリポジトリの自動有効化設定。 |
|
| reposEnablementStatus |
指定した組織内またはプロジェクト内のリポジトリの有効化状態の一覧。 |
|
| secretProtectionFeatures |
有効にできるシークレット保護機能が含まれています。 |
RepoEnablementSettings
| 名前 | 型 | 説明 |
|---|---|---|
| codeSecurityFeatures |
有効にできるコード セキュリティ機能が含まれています。 |
|
| projectId |
string (uuid) |
プロジェクト ID |
| repositoryId |
string (uuid) |
リポジトリ ID |
| secretProtectionFeatures |
有効にできるシークレット保護機能が含まれています。 |
SecretProtectionFeatures
| 名前 | 型 | 説明 |
|---|---|---|
| blockPushes |
boolean |
true の場合、シークレットを含むプッシュはブロックされます。 |
| secretProtectionChangedBy |
string (uuid) |
シークレット保護の有効化状態を変更した最後のユーザーの VSID。 |
| secretProtectionEnabled |
boolean |
シークレット保護の有効化状態が無効の場合は False に設定され、有効な場合は True に設定されます。Null が明示的に設定されることはありません。 |
| secretProtectionEnablementLastChangedDate |
string (date-time) |
このリポジトリのシークレット保護の状態が最後に更新された時刻 |