diff --git a/docs/_images/integrations/builtin/credentials/ghost/using-api.gif b/docs/_images/integrations/builtin/credentials/ghost/using-api.gif deleted file mode 100644 index 828390fbf..000000000 Binary files a/docs/_images/integrations/builtin/credentials/ghost/using-api.gif and /dev/null differ diff --git a/docs/_images/integrations/builtin/credentials/gitlab/using-access-token.gif b/docs/_images/integrations/builtin/credentials/gitlab/using-access-token.gif deleted file mode 100644 index 8fa2d0289..000000000 Binary files a/docs/_images/integrations/builtin/credentials/gitlab/using-access-token.gif and /dev/null differ diff --git a/docs/_images/integrations/builtin/credentials/gitlab/using-oauth.gif b/docs/_images/integrations/builtin/credentials/gitlab/using-oauth.gif deleted file mode 100644 index ef1b2ab70..000000000 Binary files a/docs/_images/integrations/builtin/credentials/gitlab/using-oauth.gif and /dev/null differ diff --git a/docs/integrations/builtin/credentials/gitlab.md b/docs/integrations/builtin/credentials/gitlab.md index 3f55ebf0a..123c5018b 100644 --- a/docs/integrations/builtin/credentials/gitlab.md +++ b/docs/integrations/builtin/credentials/gitlab.md @@ -13,39 +13,28 @@ You can use these credentials to authenticate the following nodes with GitLab. ## Prerequisites -Create a [GitLab](https://gitlab.com/) account. +Create a [GitLab](https://gitlab.com/){:target=_blank .external-link} account. -## Using OAuth +## Supported authentication methods + +- API access token +- OAuth2 + +## Related resources + +Refer to [GitLab's API documentation](https://docs.gitlab.com/ee/api/rest/){:target=_blank .external-link} for more information about the service. + +## Using API access token + +To configure this credential, you'll need: + +- The URL of your **GitLab Server** +- An **Access Token**: Refer to GitLab's [Create a personal access token documentation](https://docs.gitlab.com/ee/user/profile/personal_access_tokens.html#create-a-personal-access-token){:target=_blank .external-link} for detailed instructions. + +## Using OAuth2 /// note | Note for n8n Cloud users -You'll only need to enter the Credentials Name and click on the circle button in the OAuth section to connect your GitLab account to n8n. +You'll only need to enter the Credentials Name and select the **Connect my account** button in the OAuth credential to connect your _Name_ account to n8n. /// -1. Access your GitLab dashboard. -2. Click on your user icon in the top right. -3. Click on 'Settings'. -4. Click on 'Applications' in the sidebar. -5. Enter a name in the ***Name*** field. -6. Copy the 'OAuth Callback URL' provided in the 'GitLab OAuth2 API' credentials in n8n and paste it in the ***Redirect URI*** field in the GitLab app creation page. -7. Select any scopes you plan to use and then click on ***Save application***. -8. Use the ***Application ID*** and ***Secret*** with your GitLab OAuth2 API credentials in n8n. -9. Click on the circle button in the OAuth section to connect a GitLab account to n8n. -10. Click on the ***Save*** button to save your credentials. - -![Getting GitLab OAuth credentials](/_images/integrations/builtin/credentials/gitlab/using-oauth.gif) - - -## Using Access Token - -1. Access your GitLab dashboard. -2. Click on your user icon in the top right. -3. Click on 'Settings'. -4. Click on 'Access Tokens' in the sidebar. -5. Enter a name in the ***Name*** field. -6. Fill out the required information to receive the access token. -7. Select any scopes you plan to use and then click on ***Create personal access token***. -8. Use the generated access token with your GitLab node credentials in n8n. -9. Click on the ***Save*** button to save your credentials. - -![Getting GitLab access token](/_images/integrations/builtin/credentials/gitlab/using-access-token.gif) - +Should you need to configure an application with OAuth2 from scratch or need more detail on what's happening in the OAuth web flow, refer to the information and instructions in the [GitLab OAuth 2.0 identity provider API documentation](https://docs.gitlab.com/ee/api/oauth2.html){:target=_blank .external-link}.