Documentation
  • Basics
    • 🏳️Getting Started
    • ⚙️Team Management
    • ✨DevEx
      • 📋Surveys Types
    • 📁Repository Settings
      • Deployment Tracking With HTTP Request
  • ❓FAQ
  • integrations
    • Microsoft Teams
    • Bitbucket
    • Slack
    • Jira
    • Gitlab (self-managed)
    • Gitlab (Cloud)
    • Github
Powered by GitBook
On this page
  • Getting Started
  • Requirements
  • Variables Required
  • Adding Gitlab as a Git Provider
  • Create Gitlab Application
  1. integrations

Gitlab (self-managed)

This section explain how to integrate iftrue into self managed gitlab instances. If you are looking for the cloud Gitlab, check Gitlab(Cloud) page from the left.

PreviousJiraNextGitlab (Cloud)

Last updated 1 year ago

Estimated time to integrate: 4 minutes


Getting Started

Requirements

  • You have an account.

  • You have your own Gitlab instance running on your own servers. eg: gitlab.example.com

  • You have permission to create Gitlab Applications on your Gitlab Group.

Variables Required

  • Inbound IP addresses 34.36.101.243 34.36.29.18

  • Outbound IP address 34.73.236.126

  • Callback url for oAuth APP https://api.iftrue.co/v1/account/gitlab/callback

Adding Gitlab as a Git Provider

if you just signed up you will see this screen.

Create Gitlab Application

We need to create Gitlab application to integrate iftrue. To access this page,

  1. Click Create Gitlab SSO Bridge

  2. Navigate to your Gitlab group settings. (Groups -> Select Group -> Settings)

  1. Set the callback URL and requested permissions.

Copy paste the callback URL

https://api.iftrue.co/v1/account/gitlab/callback

We do not require repository read or write permissions.

  1. Copy and paste Application id and secret to iftrue

Copy those newly created application id and secret to iftrue onboarding page shown below.

  1. Enter your host url

Insert your gitlab instances URL to the host URL section. This will validate your developers with oAuth.

  1. Create Integration once done

Once you've created the application and the details, click create integration. This integration will be used by your own landing page in iftrue, which is,

https://[your-organization-slug].app.iftrue.co

When your team wants to signin you will use this address and your team will be able to signin with their Gitlab account by using oAuth 2.0.

  1. Create Access Token to Fetch Data

We need to create access token to fetch data from your gitlab instance. In order to that,

navigate to groups settings and than click Access Token

Set the token properties as below,

Copy the access token and paste it to iftrue

Hit save and you are ready to go

🎉
iftrue
Integrate GIT Provider Screen
Gitlab Group Application Settings
Gitlab Create Application
Gitlab Application Secrets
Gitlab Group Access Token Menu
Gitlab Access Token Settings
Iftrue Gitlab Access Token Settings