Name | Visibility |                                                URL

                        MaraudersMap |    Private | https://gitlab.hogwarts.local/hpotter/maraudersmap
                        testingStuff |   Internal | https://gitlab.hogwarts.local/adumbledore/testingstuff
                           Spellbook |   Internal |    https://gitlab.hogwarts.local/hpotter/spellbook
   findShortestPathToGryffindorSword |   Internal | https://gitlab.hogwarts.local/hpotter/findShortestPathToGryffindorSword
                              charms |     Public |      https://gitlab.hogwarts.local/hgranger/charms
                       Secret-Spells |   Internal | https://gitlab.hogwarts.local/adumbledore/secret-spells
                          Monitoring |   Internal | https://gitlab.hogwarts.local/gitlab-instance-10590c85/Monitoring

### 리포지토리 검색

#### 사용 사례

> *특정 SCM 시스템에서 리포지토리 이름으로 리포지토리를 검색합니다*

#### 구문

`-o` 명령줄 스위치에 `searchrepo` 모듈과 검색 조건을 제공하고, 관련 인증 정보와 URL을 함께 지정하세요. 그러면 일치하는 리포지토리 이름과 URL이 출력됩니다.

##### GitHub Enterprise

GitHub 리포지토리 검색은 "포함" 검색입니다. 즉, 입력한 문자열이 이름에 포함된 리포지토리를 검색합니다.

`SCMKit.exe -s github -m searchrepo -c userName:password -u https://github.something.local -o "some search term"`

`SCMKit.exe -s github -m searchrepo -c apikey -u https://github.something.local -o "some search term"`

##### GitLab Enterprise

GitLab 리포지토리 검색은 "포함" 검색입니다. 즉, 입력한 문자열이 이름에 포함된 리포지토리를 검색합니다.

`SCMKit.exe -s gitlab -m searchrepo -c userName:password -u https://gitlab.something.local -o "some search term"`

`SCMKit.exe -s gitlab -m searchrepo -c apikey -u https://gitlab.something.local -o "some search term"`

##### Bitbucket Server

Bitbucket 리포지토리 검색은 "시작" 검색입니다. 즉, 입력한 문자열로 시작하는 이름의 리포지토리를 검색합니다.

`SCMKit.exe -s bitbucket -m searchrepo -c userName:password -u https://bitbucket.something.local -o "some search term"`

`SCMKit.exe -s bitbucket -m searchrepo -c apikey -u https://bitbucket.something.local -o "some search term"`

#### 예제 출력```

C:\>SCMKit.exe -s gitlab -m searchrepo -c apiKey -u https://gitlab.hogwarts.local -o "spell"

==================================================
Module:         searchrepo
System:         gitlab
Auth Type:      API Key
Options:        spell
Target URL:     https://gitlab.hogwarts.local

Timestamp:      1/14/2022 8:32:30 PM
==================================================

                                    Name | Visibility |                                                URL
----------------------------------------------------------------------------------------------------------
                               Spellbook |   Internal |    https://gitlab.hogwarts.local/hpotter/spellbook
                           Secret-Spells |   Internal | https://gitlab.hogwarts.local/adumbledore/secret-spells

### 파일 검색

#### 사용 사례

> *특정 SCM 시스템의 저장소에서 파일 이름에 지정된 키워드가 포함된 파일을 검색합니다*

#### 구문

`-o` 명령줄 스위치에 `searchfile` 모듈과 검색 기준을 관련 인증 정보 및 URL과 함께 제공합니다. 그러면 해당 저장소에서 일치하는 파일의 URL이 출력됩니다.

##### GitHub Enterprise

GitLab 파일 검색은 "포함(contains)" 검색 방식으로, 입력한 문자열이 파일 이름에 포함된 파일을 검색합니다.

`SCMKit.exe -s github -m searchfile -c userName:password -u https://github.something.local -o "some search term"`

`SCMKit.exe -s github -m searchfile -c apikey -u https://github.something.local -o "some search term"`

##### GitLab Enterprise

GitLab 파일 검색은 "포함(contains)" 검색 방식으로, 입력한 문자열이 파일 이름에 포함된 파일을 검색합니다.

`SCMKit.exe -s gitlab -m searchfile -c userName:password -u https://gitlab.something.local -o "some search term"`

`SCMKit.exe -s gitlab -m searchfile -c apikey -u https://gitlab.something.local -o "some search term"`

##### Bitbucket Server

Bitbucket 파일 검색은 "포함(contains)" 검색 방식으로, 입력한 문자열이 파일 이름에 포함된 파일을 검색합니다.

`SCMKit.exe -s bitbucket -m searchfile -c userName:password -u https://bitbucket.something.local -o "some search term"`

`SCMKit.exe -s bitbucket -m searchfile -c apikey -u https://bitbucket.something.local -o "some search term"`

#### 예제 출력```

C:\source\SCMKit\SCMKit\bin\Release>SCMKit.exe -s bitbucket -m searchfile -c apikey -u http://bitbucket.hogwarts.local:7990 -o jenkinsfile

==================================================
Module:         searchfile
System:         bitbucket
Auth Type:      API Key
Options:        jenkinsfile
Target URL:     http://bitbucket.hogwarts.local:7990

Timestamp:      1/14/2022 10:17:59 PM
==================================================


[>] REPO: http://bitbucket.hogwarts.local:7990/scm/~HPOTTER/hpotter
    [>] FILE: Jenkinsfile

[>] REPO: http://bitbucket.hogwarts.local:7990/scm/STUD/cred-decryption
    [>] FILE: subDir/Jenkinsfile

Total matching results: 2

           Title |                                                                Raw URL

    spell-script |                         https://gitlab.hogwarts.local/-/snippets/2/raw

### List Runners

#### Use Case

> *GitLab에서 현재 사용자가 사용할 수 있는 모든 GitLab 러너를 나열합니다*

#### Syntax

`listrunner` 모듈과 관련 인증 정보 및 URL을 제공합니다. 사용자가 관리자인 경우 공유 러너 및 그룹 러너를 포함하여 GitLab Enterprise 인스턴스 내의 모든 러너를 나열할 수 있습니다.

##### GitLab Enterprise

`SCMKit.exe -s gitlab -m listrunner -c userName:password -u https://gitlab.something.local`

`SCMKit.exe -s gitlab -m listrunner -c apikey -u https://gitlab.something.local`

#### Example Output```

C:\>SCMKit.exe -s gitlab -m listrunner -c username:password -u https://gitlab.hogwarts.local

==================================================
Module:         listrunner
System:         gitlab
Auth Type:      Username/Password
Options:
Target URL:     https://gitlab.hogwarts.local

Timestamp:      1/25/2022 11:40:08 AM
==================================================

   ID |                 Name |                                      Repo Assigned
---------------------------------------------------------------------------------
    2 |        gitlab-runner | https://gitlab.hogwarts.local/hpotter/spellbook.git
    3 |        gitlab-runner | https://gitlab.hogwarts.local/hpotter/maraudersmap.git
    

                         Description | Visibility |                                                URL

        Shell Script to Decode Spell |     public | https://github-enterprise.hogwarts.local/gist/c11c6bb3f47fe67183d5bc9f048412a1
        

### 조직 목록

#### 사용 사례

> *현재 사용자가 GitHub에서 속한 모든 조직을 나열합니다*

#### 구문

`listorg` 모듈과 관련 인증 정보 및 URL을 제공합니다.

##### GitHub Enterprise

`SCMKit.exe -s github -m listorg -c userName:password -u https://github.something.local`

`SCMKit.exe -s github -m listorg -c apiKey -u https://github.something.local`

#### 예시 출력```

C:\>SCMKit.exe -s github -m listorg -c username:password -u https://github-enterprise.hogwarts.local

==================================================
Module:         listorg
System:         github
Auth Type:      Username/Password
Options:
Target URL:     https://github-enterprise.hogwarts.local

Timestamp:      1/14/2022 9:44:48 PM
==================================================

                          Name |                                                URL
-----------------------------------------------------------------------------------
                      Hogwarts | https://github-enterprise.hogwarts.local/api/v3/orgs/Hogwarts/repos
                      

      Token Name |    Active? |            Privilege |                                                            Description

### 관리자 추가

#### 사용 사례

> *일반 사용자를 특정 SCM 시스템의 관리자 역할로 승격합니다*

#### 구문

`addadmin` 모듈과 관련 인증 정보 및 URL을 제공합니다. 또한 관리자 역할을 추가하려는 대상 사용자를 제공합니다.

##### GitHub Enterprise

`SCMKit.exe -s github -m addadmin -c userName:password -u https://github.something.local -o targetUserName`

`SCMKit.exe -s github -m addadmin -c apikey -u https://github.something.local -o targetUserName`

##### GitLab Enterprise

`SCMKit.exe -s gitlab -m addadmin -c userName:password -u https://gitlab.something.local -o targetUserName`

`SCMKit.exe -s gitlab -m addadmin -c apikey -u https://gitlab.something.local -o targetUserName`

##### Bitbucket Server

Bitbucket에서 저장소 또는 프로젝트와 관련되지 않은 작업을 수행하려면 사용자 이름/비밀번호 인증만 지원됩니다.

`SCMKit.exe -s bitbucket -m addadmin -c userName:password -u https://bitbucket.something.local -o targetUserName`

#### 예제 출력```

C:\>SCMKit.exe -s gitlab -m addadmin -c apikey -u https://gitlab.hogwarts.local -o hgranger

==================================================
Module:         addadmin
System:         gitlab
Auth Type:      API Key
Options:        hgranger
Target URL:     https://gitlab.hogwarts.local

Timestamp:      1/14/2022 9:19:32 PM
==================================================


[+] SUCCESS: The hgranger user was successfully added to the admin role.

### 액세스 토큰 생성

#### 사용 사례

> *특정 SCM 시스템에서 사용할 액세스 토큰을 생성합니다*

#### 구문

`createpat` 모듈과 함께 관련 인증 정보 및 URL을 제공합니다. 또한 액세스 토큰을 생성하려는 대상 사용자를 지정합니다.

##### GitLab 엔터프라이즈

이 작업은 관리자만 수행할 수 있습니다. PAT를 생성하려는 사용자 이름을 지정합니다.

`SCMKit.exe -s gitlab -m createpat -c userName:password -u https://gitlab.something.local -o targetUserName`

`SCMKit.exe -s gitlab -m createpat -c apikey -u https://gitlab.something.local -o targetUserName`

##### Bitbucket 서버

인증 중인 현재 사용자에 대한 PAT를 생성합니다. Bitbucket에서는 관리자라도 다른 사용자의 PAT를 생성할 수 없습니다. Bitbucket에서 리포지토리나 프로젝트와 관련되지 않은 작업을 수행하려면 사용자 이름/암호 인증만 지원됩니다. 생성 후 표시되는 PAT ID를 기록해 두세요. 나중에 PAT를 제거해야 할 때 필요합니다.

`SCMKit.exe -s bitbucket -m createpat -c userName:password -u https://bitbucket.something.local `

#### 출력 예```

C:\>SCMKit.exe -s gitlab -m createpat -c username:password -u https://gitlab.hogwarts.local -o hgranger

==================================================
Module:         createpat
System:         gitlab
Auth Type:      Username/Password
Options:        hgranger
Target URL:     https://gitlab.hogwarts.local

Timestamp:      1/20/2022 1:51:23 PM
==================================================

   ID |         Name |                          Token
-----------------------------------------------------
   59 | SCMKIT-AaCND |           R3ySx_8HUn6UQ_6onETx

[+] SUCCESS: The hgranger user personal access token was successfully added.

### Remove Access Token

#### Use Case

> *특정 SCM 시스템에서 사용자의 액세스 토큰을 제거합니다*

#### Syntax

`removepat` 모듈과 함께 관련 인증 정보 및 URL을 제공합니다. 또한 액세스 토큰을 제거하려는 대상 사용자 PAT ID를 제공합니다.

##### GitLab Enterprise

다른 사용자의 PAT를 제거하려는 경우에만 관리자가 필요합니다. 일반 사용자는 자신의 PAT를 제거할 수 있습니다. 제거할 PAT ID를 제공해야 합니다. 이 ID는 PAT를 생성할 때와 PAT 목록을 조회할 때 표시되었습니다.

`SCMKit.exe -s gitlab -m removepat -c userName:password -u https://gitlab.something.local -o patID`

`SCMKit.exe -s gitlab -m removepat -c apikey -u https://gitlab.something.local -o patID`

##### Bitbucket Server

Bitbucket에서 저장소 또는 프로젝트와 관련되지 않은 작업을 수행하려면 사용자 이름/비밀번호 인증만 지원됩니다. 제거할 PAT ID를 제공해야 합니다. 이 ID는 PAT를 생성할 때 표시되었습니다.

`SCMKit.exe -s bitbucket -m removepat -c userName:password -u https://bitbucket.something.local -o patID`

#### Example Output```

C:\>SCMKit.exe -s gitlab -m removepat -c apikey -u https://gitlab.hogwarts.local -o 58

==================================================
Module:         removepat
System:         gitlab
Auth Type:      API Key
Options:        59
Target URL:     https://gitlab.hogwarts.local

Timestamp:      1/20/2022 1:56:47 PM
==================================================



[*] INFO: Revoking personal access token of ID: 59


[+] SUCCESS: The personal access token of ID 59 was successfully revoked.

      16

### SSH 키 나열

#### 사용 사례

> *특정 SCM 시스템의 사용자에 대한 SSH 키를 나열합니다*

#### 구문

관련 인증 정보 및 URL과 함께 `listsshkey` 모듈을 제공하십시오.

##### GitHub Enterprise

현재 사용자의 SSH 키를 나열합니다. 여기에는 SSH 키를 제거하려는 경우 필요한 SSH 키 ID가 포함됩니다.

`SCMKit.exe -s github -m listsshkey -c userName:password -u https://github.something.local`

`SCMKit.exe -s github -m listsshkey -c apiToken -u https://github.something.local`

##### GitLab Enterprise

현재 사용자의 SSH 키를 나열합니다.

`SCMKit.exe -s gitlab -m listsshkey -c userName:password -u https://gitlab.something.local`

`SCMKit.exe -s gitlab -m listsshkey -c apiToken -u https://gitlab.something.local`


##### Bitbucket Server

현재 사용자의 SSH 키를 나열합니다. Bitbucket에서 리포지토리 또는 프로젝트와 관련되지 않은 작업을 수행하려면 사용자 이름/비밀번호 인증만 지원됩니다.

`SCMKit.exe -s bitbucket -m listsshkey -c userName:password -u https://bitbucket.something.local`


#### 예제 출력```

C:\>SCMKit.exe -s gitlab -m listsshkey -u http://gitlab.hogwarts.local -c apiToken

==================================================
Module:         listsshkey
System:         gitlab
Auth Type:      API Key
Options:
Target URL:     https://gitlab.hogwarts.local

Timestamp:      2/7/2022 4:09:40 PM
==================================================

  SSH Key ID |             SSH Key Value |                Title
---------------------------------------------------------------
           9 | .....p50edigBAF4lipVZkAM= |         SCMKIT-RLzie
          10 | .....vGJLPGHiTwIxW9i+xAs= |         SCMKIT-muFGU
    

### 관리자 통계 나열

#### 사용 사례

> *GitHub Enterprise에서 관리자 통계 나열*

#### 구문

`adminstats` 모듈과 함께 관련 인증 정보 및 URL을 제공합니다. 이 모듈을 사용하려면 GitHub Enterprise에서 사이트 관리자 액세스 권한이 필요합니다.

##### GitHub Enterprise

`SCMKit.exe -s github -m adminstats -c userName:password -u https://github.something.local`

`SCMKit.exe -s github -m adminstats -c apikey -u https://github.something.local`

#### 예제 출력```

C:\>SCMKit.exe -s github -m adminstats -c username:password -u https://github-enterprise.hogwarts.local

==================================================
Module:         adminstats
System:         github
Auth Type:      Username/Password
Options:
Target URL:     https://github-enterprise.hogwarts.local

Timestamp:      1/14/2022 9:45:50 PM
==================================================

     Admin Users |  Suspended Users |      Total Users
------------------------------------------------------
               1 |                0 |                5


     Total Repos |      Total Wikis
-----------------------------------
               4 |                0


      Total Orgs |   Total Team Members |      Total Teams
----------------------------------------------------------
               1 |                    0 |                0


   Private Gists |     Public Gists
-----------------------------------
               0 |                1
               

                 Repo |                    Branch |                                         Protection

          public-repo |                       dev | Protected: True
                                                    Status checks must pass before merge:
                                                      Branch must be up-to-date before merge: True
                                                    Owner review required before merge: True
                                                    Approvals required before merge: 2
                                                    Protections apply to repo admins: True
          public-repo |                      main | Protected: False

## 탐지

다음은 이 도구가 기본 상태에서 사용될 때의 정적 서명입니다:

* 프로젝트 GUID - `{266C644A-69B1-426B-A47C-1CF32B211F80}`
  * 이 저장소의 [SCMKit Yara 규칙](https://github.com/xforcered/scmkit/blob/main/Detections/SCMKit.yar)을 참조하세요.
* User-Agent 문자열 - `SCMKIT-5dc493ada400c79dd318abbe770dac7c`
  * 이 저장소의 [SCMKit Snort 규칙](https://github.com/xforcered/scmkit/blob/main/Detections/SCMKit.rules)을 참조하세요.
* 액세스 토큰 및 SSH 키 이름 - 이 도구를 사용하여 생성된 액세스 토큰과 SSH 키의 이름에는 `SCMKIT-` 접두사가 붙습니다.

도구에서 사용되는 기법에 대한 탐지 지침은 X-Force Red [블로그 게시물](https://securityintelligence.com/posts/abusing-source-code-management-systems)을 참조하세요.

## 참고 자료
* Bitbucket API 문서 
  * https://developer.atlassian.com/server/bitbucket/reference/rest-api/
* Octokit 문서
  * https://octokitnet.readthedocs.io/en/latest/
  * https://github.com/octokit/octokit.net
* GitHub API 문서
  * https://docs.github.com/en/rest/overview
* GitLab API 문서
  * https://docs.gitlab.com/ee/api/api_resources.html
* GitLabApiClient Nuget 패키지 문서
  * https://github.com/nmklotas/GitLabApiClient