보안 관리자 - GitHub Enterprise Server 3.7 Docs

REST API를 사용하여 조직의 보안 관리자를 관리합니다.

보안 관리자 정보

참고: 보안 관리자 역할은 퍼블릭 베타 버전이며 변경될 수 있습니다.

보안 관리자는 조직 소유자가 조직의 모든 팀에 할당할 수 있는 조직 수준 역할입니다. 적용하면 모든 팀 구성원에게 조직 전체의 보안 경고 및 설정을 보고 코드 보안에 대한 설정을 관리할 수 있는 권한과 조직의 모든 리포지토리에 대한 읽기 권한을 부여합니다.

경고: 팀에서 보안 관리자 역할을 제거하면 조직 전체에서 보안 경고 및 설정을 관리하는 팀의 기능이 제거되지만, 팀은 역할이 할당되었을 때 부여된 리포지토리에 대한 읽기 권한을 유지합니다. 원치 않는 읽기 액세스를 수동으로 제거해야 합니다. 자세한 내용은 "조직 리포지토리에 대한 팀 액세스 관리"을(를) 참조하세요.

List security manager teams

Works with GitHub Apps

Lists teams that are security managers for an organization. For more information, see "Managing security managers in your organization."

To use this endpoint, you must be an administrator or security manager for the organization, and you must use an access token with the read:org scope.

GitHub Apps must have the administration organization read permission to use this endpoint.

"List security manager teams"에 대한 매개 변수

머리글
이름, Type, 설명
`accept` string Setting to `application/vnd.github+json` is recommended.

경로 매개 변수
이름, Type, 설명
`org` string Required The organization name. The name is not case sensitive.

"List security manager teams"에 대한 HTTP 응답 상태 코드

상태 코드	설명
`200`	OK

"List security manager teams"에 대한 코드 샘플

get/orgs/{org}/security-managers

curl -L \
  -H "Accept: application/vnd.github+json" \
  -H "Authorization: Bearer <YOUR-TOKEN>" \
  http(s)://HOSTNAME/api/v3/orgs/ORG/security-managers

Response

Status: 200

[
  {
    "id": 1,
    "node_id": "MDQ6VGVhbTE=",
    "url": "https://HOSTNAME/teams/1",
    "html_url": "https://github.com/orgs/github/teams/justice-league",
    "name": "Justice League",
    "slug": "justice-league",
    "description": "A great team.",
    "privacy": "closed",
    "permission": "admin",
    "members_url": "https://HOSTNAME/teams/1/members{/member}",
    "repositories_url": "https://HOSTNAME/teams/1/repos",
    "parent": null
  }
]

Add a security manager team

Works with GitHub Apps

Adds a team as a security manager for an organization. For more information, see "Managing security for an organization for an organization."

To use this endpoint, you must be an administrator for the organization, and you must use an access token with the write:org scope.

GitHub Apps must have the administration organization read-write permission to use this endpoint.

"Add a security manager team"에 대한 매개 변수

머리글
이름, Type, 설명
`accept` string Setting to `application/vnd.github+json` is recommended.

경로 매개 변수
이름, Type, 설명
`org` string Required The organization name. The name is not case sensitive.
`team_slug` string Required The slug of the team name.

"Add a security manager team"에 대한 HTTP 응답 상태 코드

상태 코드	설명
`204`	No Content
`409`	The organization has reached the maximum number of security manager teams.

"Add a security manager team"에 대한 코드 샘플

put/orgs/{org}/security-managers/teams/{team_slug}

curl -L \
  -X PUT \
  -H "Accept: application/vnd.github+json" \
  -H "Authorization: Bearer <YOUR-TOKEN>" \
  http(s)://HOSTNAME/api/v3/orgs/ORG/security-managers/teams/TEAM_SLUG

Response

Status: 204

Remove a security manager team

Works with GitHub Apps

Removes the security manager role from a team for an organization. For more information, see "Managing security managers in your organization team from an organization."

To use this endpoint, you must be an administrator for the organization, and you must use an access token with the admin:org scope.

GitHub Apps must have the administration organization read-write permission to use this endpoint.

"Remove a security manager team"에 대한 매개 변수

머리글
이름, Type, 설명
`accept` string Setting to `application/vnd.github+json` is recommended.

경로 매개 변수
이름, Type, 설명
`org` string Required The organization name. The name is not case sensitive.
`team_slug` string Required The slug of the team name.

"Remove a security manager team"에 대한 HTTP 응답 상태 코드

상태 코드	설명
`204`	No Content

"Remove a security manager team"에 대한 코드 샘플

delete/orgs/{org}/security-managers/teams/{team_slug}

curl -L \
  -X DELETE \
  -H "Accept: application/vnd.github+json" \
  -H "Authorization: Bearer <YOUR-TOKEN>" \
  http(s)://HOSTNAME/api/v3/orgs/ORG/security-managers/teams/TEAM_SLUG

Response

Status: 204