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

### Rechercher des 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 le paramètre de ligne de commande `-o`, ainsi que toutes les informations d'authentification pertinentes et l'URL. Cela renverra le nom et l'URL du dépôt correspondant.

##### GitHub Enterprise

La recherche de dépôts GitHub est une recherche de type « contient » où la chaîne que vous saisissez recherchera les dépôts dont le nom contient 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 de type « contient » où la chaîne que vous saisissez recherchera les dépôts dont le nom contient 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 de type « commence par » où la chaîne que vous saisissez recherchera les dépôts dont le nom commence 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

### Rechercher des 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 toute information d'authentification pertinente et l'URL. Cela affichera l'URL du fichier correspondant dans son dépôt respectif.

##### GitHub Enterprise

La recherche de fichiers GitLab est une recherche « contient » où la chaîne que vous saisissez recherchera les fichiers qui contiennent votre terme de recherche dans le nom de fichier.

`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 « contient » où la chaîne que vous saisissez recherchera les fichiers qui contiennent votre terme de recherche dans le nom de fichier.

`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 « contient » où la chaîne que vous saisissez recherchera les fichiers qui contiennent votre terme de recherche dans le nom de fichier.

`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

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

#### Syntaxe

Fournissez le module `listrunner`, ainsi que toutes les informations d'authentification et l'URL pertinentes. Si l'utilisateur est un administrateur, vous pourrez lister tous les runners de l'instance GitLab Enterprise, y compris les runners partagés et 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 dans GitHub*

#### Syntaxe

Fournissez le module `listorg`, ainsi que 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 toute information d'authentification pertinente et l'URL. De plus, indiquez l'utilisateur cible auquel vous souhaitez ajouter un rôle d'administration.

##### 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 pertinente. De plus, fournissez l'utilisateur cible pour lequel vous souhaitez créer un jeton d'accès.

##### GitLab Enterprise

Cela ne peut être effectué que par un 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 actuel qui s'authentifie. Dans Bitbucket, vous ne pouvez pas créer de 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 projets dans Bitbucket. Notez l'ID du PAT qui s'affiche après sa création. Vous en aurez besoin lorsque vous devrez 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. De plus, fournissez l'ID du PAT de l'utilisateur cible pour lequel vous souhaitez supprimer un jeton d'accès.

##### GitLab Enterprise

Nécessite seulement les droits d'administrateur si vous voulez supprimer le PAT d'un autre utilisateur. Un utilisateur régulier peut supprimer son propre PAT. Vous devez fournir l'ID du PAT à supprimer. Cet ID était affiché lors de la création du PAT et également 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

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

#### Syntaxe

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

##### GitHub Enterprise

Liste les clés SSH pour l'utilisateur actuel. Cela inclut les identifiants des clés SSH, 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 pour 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 pour 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 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
    

### Lister les statistiques d'administration

#### Cas d'utilisation

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

#### Syntaxe

Fournissez le module `adminstats`, ainsi que toute information d'authentification et URL pertinente. L'accès administrateur du 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 résultat```

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 les 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/h4wkst3r/scmkit/blob/HEAD/Detections/SCMKit.yar) dans ce dépôt.
* Chaîne User-Agent - `SCMKIT-5dc493ada400c79dd318abbe770dac7c`
  * Voir [Règle Snort SCMKit](https://github.com/h4wkst3r/scmkit/blob/HEAD/Detections/SCMKit.rules) dans ce dépôt.
* Noms des jetons d'accès et clés SSH - Les jetons d'accès et les clés SSH créés à l'aide de l'outil sont précédés de `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