To connect Azure DevOps Server to Keypup, a user or administrator must create a Personal Access Token (PAT) through their profile settings.
A PAT is required since Azure DevOps Server does not support OAuth applications.
Follow the steps below to create this PAT link and connect your Azure DevOps server to Keypup:
1. (Optional) If your Azure DevOps Server is protected behind a firewall, you can allow Keypup API calls by whitelisting the following IP addresses:
35.227.8.11334.139.100.4104.196.223.12434.23.243.137
2. Log into your Azure DevOps Server, click on your Profile Picture at the top right, and select Security
3. Select the Personal access tokens menu on the left, then click on New Token at the top right
4. Click on Show all scopes at the bottom to display all the available scopes. Azure DevOps only shows the most common scopes by default.
5. Use the following details to configure your Personal Access Token (PAT)
Name | Keypup |
Organization | All accessible organizations If you do not select this option, the connection process will fail. |
Expiration | Use the calendar and select the furthest date possible (1 year from now) In one year, you will have to edit the token, extend the expiration, and then reconnect Azure DevOps. |
Permissions | Build: Read Code: Read Identity: Read Work items: Read |
6. Copy your newly created token
7. Back onto the Azure DevOps Server connection process on Keypup, just click on Yes, I’ve created the PAT
8. Fill out the connection details for your Azure DevOps Server instance using the PAT generated in step 6.
Azure DevOps Server instances with self-signed certificates
Keypup assumes and recommends the use of publicly recognized SSL certificates (e.g., from DigiCert, Let's Encrypt, etc.) for your server. API calls to your Azure DevOps Server instance always validate the SSL certificate in use. Expired or invalid certificates will eventually lead to the disconnection of your projects.
If your team uses a self-signed certificate on your Azure DevOps Server, then you must disable SSL verification when setting up the connection. We do not recommend it, but we still offer the option for convenience.
9. If the connection details are correct and we can establish a connection, you will be redirected to the projects page on Keypup. From there, you will be able to select the projects to import.