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

### Repositories durchsuchen

#### Anwendungsfall

> *Suche nach Repositories anhand des Repository-Namens in einem bestimmten SCM-System*

#### Syntax

Geben Sie das Modul `searchrepo` und Ihre Suchkriterien im Befehlszeilenschalter `-o` an, zusammen mit allen relevanten Authentifizierungsinformationen und der URL. Dies gibt den passenden Repository-Namen und die URL aus.

##### GitHub Enterprise

Die GitHub-Repository-Suche ist eine „enthält“-Suche, bei der die eingegebene Zeichenfolge nach Repositories sucht, deren Namen Ihren Suchbegriff enthalten.

`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

Die GitLab-Repository-Suche ist eine „enthält“-Suche, bei der die eingegebene Zeichenfolge nach Repositories sucht, deren Namen Ihren Suchbegriff enthalten.

`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

Die Bitbucket-Repository-Suche ist eine „beginnt mit“-Suche, bei der die eingegebene Zeichenfolge nach Repositories sucht, deren Namen mit Ihrem Suchbegriff beginnen.

`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"`

#### Beispielausgabe```

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

### Dateien durchsuchen

#### Anwendungsfall

> *Suche nach Dateien in Repositorys, die einen bestimmten Suchbegriff im Dateinamen enthalten, in einem bestimmten SCM-System*

#### Syntax

Gib das Modul `searchfile` und deine Suchkriterien im Befehlszeilenschalter `-o` an, zusammen mit den relevanten Authentifizierungsinformationen und der URL. Dadurch wird die URL zu der passenden Datei in ihrem jeweiligen Repository ausgegeben.

##### GitHub Enterprise

Die GitLab-Dateisuche ist eine „contains“-Suche, bei der der eingegebene Suchbegriff nach Dateien sucht, deren Dateiname deinen Suchbegriff enthält.

`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

Die GitLab-Dateisuche ist eine „contains“-Suche, bei der der eingegebene Suchbegriff nach Dateien sucht, deren Dateiname deinen Suchbegriff enthält.

`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

Die Bitbucket-Dateisuche ist eine „contains“-Suche, bei der der eingegebene Suchbegriff nach Dateien sucht, deren Dateiname deinen Suchbegriff enthält.

`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"`

#### Beispielausgabe```

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

### Runner auflisten

#### Anwendungsfall

> *Liste alle GitLab-Runner auf, die dem aktuellen Benutzer in GitLab zur Verfügung stehen*

#### Syntax

Stellen Sie das Modul `listrunner` zusammen mit allen relevanten Authentifizierungsinformationen und der URL bereit. Wenn der Benutzer ein Administrator ist, können Sie alle Runner innerhalb der GitLab-Enterprise-Instanz auflisten, einschließlich gemeinsamer und Gruppen-Runner.

##### 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`

#### Beispielausgabe```

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
        

### Organisationen auflisten

#### Anwendungsfall

> *Liste alle Organisationen auf, zu denen der aktuelle Benutzer auf GitHub gehört*

#### Syntax

Stellen Sie das `listorg`-Modul sowie alle relevanten Authentifizierungsinformationen und die URL bereit.

##### 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`

#### Beispielausgabe```

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

### Admin hinzufügen

#### Anwendungsfall

> *Einen normalen Benutzer in eine administrative Rolle in einem bestimmten SCM-System befördern*

#### Syntax

Geben Sie das `addadmin`-Modul sowie alle relevanten Authentifizierungsinformationen und die URL an. Geben Sie außerdem den Zielbenutzer an, dem Sie eine administrative Rolle zuweisen möchten.

##### 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

Nur die Authentifizierung mit Benutzername/Kennwort wird unterstützt, um Aktionen auszuführen, die nicht mit Repos oder Projekten in Bitbucket zusammenhängen.

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

#### Beispielausgabe```

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.

### Zugriffstoken erstellen

#### Anwendungsfall

> *Ein Zugriffstoken zur Verwendung in einem bestimmten SCM-System erstellen*

#### Syntax

Stellen Sie das `createpat`-Modul zusammen mit allen relevanten Authentifizierungsinformationen und der URL bereit. Geben Sie außerdem den Zielbenutzer an, für den Sie ein Zugriffstoken erstellen möchten.

##### GitLab Enterprise

Dies kann nur als Administrator durchgeführt werden. Sie geben den Benutzernamen an, für den Sie ein PAT erstellen möchten.

`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 Server

Erstellt ein PAT für den Benutzer, der sich gerade authentifiziert. In Bitbucket können Sie kein PAT für einen anderen Benutzer erstellen, selbst nicht als Administrator. Für Aktionen, die nicht mit Repos oder Projekten in Bitbucket zusammenhängen, wird nur die Benutzername/Passwort-Authentifizierung unterstützt. Notieren Sie sich die PAT-ID, die nach der Erstellung angezeigt wird. Sie benötigen diese, wenn Sie das PAT in Zukunft entfernen müssen.

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

#### Beispielausgabe```

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.

### Access Token entfernen

#### Anwendungsfall

> *Entfernen eines Access Tokens für einen Benutzer in einem bestimmten SCM-System*

#### Syntax

Stellen Sie das `removepat`-Modul zusammen mit den relevanten Authentifizierungsinformationen und der URL bereit. Geben Sie außerdem die PAT-ID des Zielbenutzers an, für die Sie ein Access Token entfernen möchten.

##### GitLab Enterprise

Erfordert nur Administratorrechte, wenn Sie das PAT eines anderen Benutzers entfernen möchten. Ein normaler Benutzer kann sein eigenes PAT entfernen. Sie müssen die zu entfernende PAT-ID angeben. Diese ID wurde Ihnen angezeigt, wenn Sie das PAT erstellt und auch, wenn Sie die PATs aufgelistet haben.

`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

Für Aktionen, die nicht mit Repos oder Projekten in Bitbucket zusammenhängen, wird nur die Benutzername/Kennwort-Authentifizierung unterstützt. Sie müssen die zu entfernende PAT-ID angeben. Diese ID wurde angezeigt, als Sie das PAT erstellt haben.

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

#### Beispielausgabe```

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-Schlüssel auflisten

#### Anwendungsfall

> *SSH-Schlüssel für einen Benutzer in einem bestimmten SCM-System auflisten*

#### Syntax

Stellen Sie das Modul `listsshkey` sowie alle relevanten Authentifizierungsinformationen und die URL bereit.

##### GitHub Enterprise

SSH-Schlüssel für den aktuellen Benutzer auflisten. Dies enthält die SSH-Schlüssel-IDs, die benötigt werden, wenn Sie einen SSH-Schlüssel entfernen möchten.

`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-Schlüssel für den aktuellen Benutzer auflisten.

`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-Schlüssel für den aktuellen Benutzer auflisten. Nur die Authentifizierung mit Benutzername/Kennwort wird unterstützt, um Aktionen auszuführen, die nicht mit Repos oder Projekten in Bitbucket zusammenhängen.

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


#### Beispielausgabe```

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
    

### Admin-Statistiken auflisten

#### Anwendungsfall

> *Admin-Statistiken in GitHub Enterprise auflisten*

#### Syntax

Stelle das `adminstats`-Modul zusammen mit den relevanten Authentifizierungsinformationen und der URL bereit. Für die Verwendung dieses Moduls ist Site-Admin-Zugriff in GitHub Enterprise erforderlich.

##### 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`

#### Beispielausgabe```

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

## Erkennung

Im Folgenden finden Sie statische Signaturen für die spezifische Verwendung dieses Tools im Standardzustand:

* Projekt-GUID - `{266C644A-69B1-426B-A47C-1CF32B211F80}`
  * Siehe [SCMKit-Yara-Regel](https://github.com/xforcered/scmkit/blob/HEAD/Detections/SCMKit.yar) in diesem Repository.
* User-Agent-String - `SCMKIT-5dc493ada400c79dd318abbe770dac7c`
  * Siehe [SCMKit-Snort-Regel](https://github.com/xforcered/scmkit/blob/HEAD/Detections/SCMKit.rules) in diesem Repository.
* Namen für Access Tokens und SSH-Schlüssel - Access Tokens und SSH-Schlüssel, die mit dem Tool erstellt werden, erhalten als Präfix den Namen `SCMKIT-`.

Hinweise zur Erkennung der vom Tool verwendeten Techniken finden Sie im X-Force-Red-[Blogbeitrag](https://securityintelligence.com/posts/abusing-source-code-management-systems).

## Referenzen
* Bitbucket-API-Dokumentation
  * https://developer.atlassian.com/server/bitbucket/reference/rest-api/
* Octokit-Dokumentation
  * https://octokitnet.readthedocs.io/en/latest/
  * https://github.com/octokit/octokit.net
* GitHub-API-Dokumentation
  * https://docs.github.com/en/rest/overview
* GitLab-API-Dokumentation
  * https://docs.gitlab.com/ee/api/api_resources.html
* Dokumentation des GitLabApiClient-NuGet-Pakets
  * https://github.com/nmklotas/GitLabApiClient