# GitLab CI/CD

Bitwarden biedt een manier om secrets in je [GitLab CI/CD](https://docs.gitlab.com/ee/ci/) pipelines te injecteren met behulp van de Bitwarden [Secrets Manager CLI](https://bitwarden.com/nl-nl/help/secrets-manager-cli/). Hiermee kun je veilig geheimen opslaan en gebruiken in je CI/CD workflows. Om te beginnen:

## Een toegangstoken opslaan

In deze stap gaan we een [toegangstoken](https://bitwarden.com/nl-nl/help/access-tokens/) opslaan als een GitLab CI/CD variabele. Dit token wordt gebruikt om te authenticeren met de Bitwarden Secrets Manager API en [geheimen](https://bitwarden.com/nl-nl/help/secrets/) op te halen.

1. Navigeer in GitLab naar de **Instellingen** > **CI/CD** pagina van je project.
2. Selecteer **Uitbreiden** in het gedeelte **Variabelen**.
3. Selecteer **Variabele toevoegen**.
4. Controleer de **maskervariabele**vlag.
5. Geef de sleutel de naam `BWS_ACCESS_TOKEN`. Dit is de variabele waarnaar de Secrets Manager CLI zoekt om [te authenticeren](https://bitwarden.com/nl-nl/help/secrets-manager-cli/#authentication/). Als je de sleutel een andere naam wilt geven, geef dan later `--access-token NAME_OF_VAR` op de regel `bws secret get`.
6. Open in een ander tabblad de webapp Secrets Manager en [maak een toegangstoken aan](https://bitwarden.com/nl-nl/help/access-tokens/).
7. Terug in GitLab, plak het nieuw aangemaakte toegangstoken in het **Waarde**veld.
8. Selecteer **Variabele toevoegen** om op te slaan.

![Een variabele toevoegen in GitLab](https://bitwarden.com/assets/5oaev7YcHn7ndLaofLb8Uw/2c653506fca3ca2300ce93e226e163e8/gitlab_variables.png)

## Toevoegen aan uw workflowbestand

Vervolgens gaan we een rudimentaire GitLab CI/CD workflow schrijven. Maak een bestand genaamd `.gitlab-ci.yml` aan in de root van je repository met de volgende inhoud:

```bash
stages:
- default_runner

image: ubuntu
build:
 stage: default_runner
 script: 
 - |
 # install bws
 apt-get update && apt-get install -y curl git jq unzip
 export BWS_VER="1.0.0"
 curl -LO \
 "https://github.com/bitwarden/sdk/releases/download/bws-v$BWS_VER/bws-x86_64-unknown-linux-gnu-$BWS_VER.zip"
 unzip -o bws-x86_64-unknown-linux-gnu-$BWS_VER.zip -d /usr/local/bin

 # use the `bws run` command to inject secrets into your commands
 - bws run -- 'npm run start'
```

Waar:

- `BWS_VER` is de versie van de Bitwarden Secrets Manager CLI die geïnstalleerd moet worden. Hier krijgen we automatisch de nieuwste versie. Je kunt de versie die geïnstalleerd wordt vastpinnen door dit te veranderen in een specifieke versie, bijvoorbeeld `BWS_VER="0.3.1".`
- `534cc788-a143-4743-94f5-afdb00a40a41` en `9a0b500c-cb3a-42b2-aaa2-afdb00a41daa` zijn referentie-identifiers voor geheimen opgeslagen in Secrets Manager. De serviceaccount waar je toegangstoken bij horen moet toegang hebben tot deze specifieke geheimen.
- `npm run start` is het commando dat de geheime waarden verwacht die worden opgehaald door `bws`. Vervang dit door de relevante commando's om je project uit te voeren.

> [!WARNING] Don't use command that output in logs.
> Geheimen worden opgeslagen als omgevingsvariabelen. Het is belangrijk om te [voorkomen dat commando's worden uitgevoerd die deze geheimen naar de logs zouden uitvoeren](https://docs.gitlab.com/ee/ci/variables/#cicd-variable-security).

## De CI/CD-pijplijn uitvoeren

Selecteer aan de linkerkant **Build** > **Pipelines** en selecteer **Run pipeline** rechtsboven in het tempo. Selecteer **Voer pijplijn uit**op de pagina om de nieuw aangemaakte pijplijn uit te voeren.