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

### Recherche de dépôts

#### Cas d'utilisation

> *Rechercher des dépôts par nom de dépôt dans un système SCM particulier.*

#### Syntaxe

Fournissez le module `searchrepo` et vos critères de recherche dans l'option de ligne de commande `-o`, ainsi que les informations d'authentification et l'URL pertinentes. Cela affichera le nom et l'URL du dépôt correspondant.

##### GitHub Enterprise

La recherche de dépôts GitHub est une recherche « contient » dans laquelle la chaîne que vous saisissez recherche les dépôts dont les noms contiennent votre terme de recherche.

`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

La recherche de dépôts GitLab est une recherche « contient » dans laquelle la chaîne que vous saisissez recherche les dépôts dont les noms contiennent votre terme de recherche.

`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

La recherche de dépôts Bitbucket est une recherche « commence par » dans laquelle la chaîne que vous saisissez recherche les dépôts dont les noms commencent par votre terme de recherche.

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

#### Exemple de sortie```

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

### Recherche de fichiers

#### Cas d'utilisation

> *Rechercher des fichiers dans les dépôts contenant un mot-clé donné dans le nom de fichier dans un système SCM particulier*

#### Syntaxe

Fournissez le module `searchfile` et vos critères de recherche dans le commutateur de ligne de commande `-o`, ainsi que les informations d'authentification et l'URL pertinentes. Cela affichera l'URL du fichier correspondant dans son dépôt respectif.

##### GitHub Enterprise

La recherche de fichiers GitLab est une recherche de type "contient" : la chaîne que vous saisissez recherchera les fichiers dont le nom de fichier contient votre terme de recherche.

`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

La recherche de fichiers GitLab est une recherche de type "contient" : la chaîne que vous saisissez recherchera les fichiers dont le nom de fichier contient votre terme de recherche.

`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

La recherche de fichiers Bitbucket est une recherche de type "contient" : la chaîne que vous saisissez recherchera les fichiers dont le nom de fichier contient votre terme de recherche.

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

#### Exemple de sortie```

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

### Lister les runners

#### Cas d'utilisation

> *Lister tous les runners GitLab disponibles pour l'utilisateur actuel dans GitLab*

#### Syntaxe

Fournissez le module `listrunner`, ainsi que toute information d'authentification pertinente et l'URL. Si l'utilisateur est un administrateur, vous pourrez lister tous les runners de l'instance GitLab Enterprise, y compris les runners partagés et ceux de groupe.

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

#### Exemple de sortie```

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
        

### Lister les organisations

#### Cas d'utilisation

> *Lister toutes les organisations auxquelles l'utilisateur actuel appartient sur GitHub*

#### Syntaxe

Fournissez le module `listorg`, ainsi que toutes les informations d'authentification et l'URL pertinentes.

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

#### Exemple de sortie```

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

### Ajouter un administrateur

#### Cas d'utilisation

> *Promouvoir un utilisateur normal à un rôle d'administrateur dans un système SCM particulier*

#### Syntaxe

Fournissez le module `addadmin`, ainsi que les informations d'authentification pertinentes et l'URL. De plus, fournissez l'utilisateur cible auquel vous souhaitez ajouter un rôle administratif.

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

Seule l'authentification par nom d'utilisateur/mot de passe est prise en charge pour effectuer des actions non liées aux dépôts ou aux projets dans Bitbucket.

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

#### Exemple de sortie```

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.

### Créer un jeton d'accès

#### Cas d'utilisation

> *Créer un jeton d'accès à utiliser dans un système SCM particulier*

#### Syntaxe

Fournissez le module `createpat`, ainsi que toute information d'authentification et URL pertinentes. En outre, fournissez l'utilisateur cible pour lequel vous souhaitez créer un jeton d'accès.

##### GitLab Enterprise

Cette opération ne peut être effectuée qu'en tant qu'administrateur. Vous fournirez le nom d'utilisateur pour lequel vous souhaitez créer un 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 Server

Crée un PAT pour l'utilisateur actuellement authentifié. Dans Bitbucket, vous ne pouvez pas créer un PAT pour un autre utilisateur, même en tant qu'administrateur. Seule l'authentification par nom d'utilisateur/mot de passe est prise en charge pour effectuer des actions non liées aux dépôts ou aux projets dans Bitbucket. Notez l'identifiant PAT affiché après la création. Vous en aurez besoin lorsqu'il vous faudra supprimer le PAT à l'avenir.

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

#### Exemple de sortie```

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.

### Supprimer le jeton d'accès

#### Cas d'utilisation

> *Supprimer un jeton d'accès pour un utilisateur dans un système SCM particulier*

#### Syntaxe

Fournissez le module `removepat`, ainsi que les informations d'authentification et l'URL pertinentes. En outre, fournissez l'ID PAT de l'utilisateur cible pour lequel vous souhaitez supprimer un jeton d'accès.

##### GitLab Enterprise

Nécessite uniquement les droits d'administration si vous souhaitez supprimer le PAT d'un autre utilisateur. Un utilisateur standard peut supprimer son propre PAT. Vous devez fournir l'ID du PAT à supprimer. Cet ID était affiché lors de la création du PAT ainsi que lors de la liste des 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

Seule l'authentification par nom d'utilisateur/mot de passe est prise en charge pour effectuer des actions non liées aux dépôts ou aux projets dans Bitbucket. Vous devez fournir l'ID du PAT à supprimer. Cet ID était affiché lors de la création du PAT.

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

#### Exemple de sortie```

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

### Lister les clés SSH

#### Cas d'utilisation

> *Lister les clés SSH d'un utilisateur sur un système SCM particulier.*

#### Syntaxe

Fournissez le module `listsshkey`, ainsi que toutes les informations d'authentification pertinentes et l'URL. 

##### GitHub Enterprise

Liste les clés SSH de l'utilisateur actuel. Cela inclura les identifiants des clés SSH, qui sont nécessaires si vous souhaitez supprimer une clé SSH.

`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

Liste les clés SSH de l'utilisateur actuel.

`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

Liste les clés SSH de l'utilisateur actuel. Seule l'authentification par nom d'utilisateur/mot de passe est prise en charge pour effectuer des actions non liées aux dépôts ou aux projets dans Bitbucket.

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


#### Exemple de sortie```

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
    

### List Admin Stats

#### Use Case

> *Lister les statistiques d'administration dans GitHub Enterprise*

#### Syntaxe

Fournissez le module `adminstats`, ainsi que les informations d'authentification et l'URL pertinentes. Un accès administrateur de site dans GitHub Enterprise est requis pour utiliser ce module.

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

#### Exemple de sortie```

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

## Détection

Vous trouverez ci-dessous des signatures statiques pour l'utilisation spécifique de cet outil dans son état par défaut :

* GUID du projet - `{266C644A-69B1-426B-A47C-1CF32B211F80}`
  * Voir [règle Yara SCMKit](https://github.com/xforcered/scmkit/blob/main/Detections/SCMKit.yar) dans ce dépôt.
* Chaîne User-Agent - `SCMKIT-5dc493ada400c79dd318abbe770dac7c`
  * Voir [règle Snort SCMKit](https://github.com/xforcered/scmkit/blob/main/Detections/SCMKit.rules) dans ce dépôt.
* Noms des jetons d'accès et des clés SSH - Les jetons d'accès et les clés SSH créés à l'aide de l'outil sont préfixés par `SCMKIT-` pour le nom.

Pour des conseils de détection des techniques utilisées par l'outil, consultez le [billet de blog](https://securityintelligence.com/posts/abusing-source-code-management-systems) de X-Force Red.

## Références
* Documentation de l'API Bitbucket 
  * https://developer.atlassian.com/server/bitbucket/reference/rest-api/
* Documentation Octokit
  * https://octokitnet.readthedocs.io/en/latest/
  * https://github.com/octokit/octokit.net
* Documentation de l'API GitHub
  * https://docs.github.com/en/rest/overview
* Documentation de l'API GitLab
  * https://docs.gitlab.com/ee/api/api_resources.html
* Documentation du package Nuget GitLabApiClient
  * https://github.com/nmklotas/GitLabApiClient