How to use Github.com for TeamCity Authentication?

No matter if you are using TeamCity as an admin or you just want to learn and you are playing a little bit with a dedicated TeamCity server, today I will show you / explain how you can use github.com to signup and sign in into your server.

What you need?

1. A Github.com account. You can use a free account or a pro account
2. A TeamCity server. Doesn't matter how you turned it ON (docker or classic install

Let's see the steps to implement Github.com authentication method in order to login and signup into your TeamCity Server

• Create an organization in GitHub (https://github.com/settings/organizations )
• Click on new organization and setup a dummy one

• Log in into your TeamCity Server
• Go to Administration-> Root project

• Click on connection -> Add Connection -> connection type: Github.com

• Register your TeamCity server to OAuth application in GitHub (https://github.com/settings/developers )
• Add Application name
• Add Homepage URL (provided by TeamCity)
• Add Authorization callback URL (provided by TeamCity)
• Grab your Client ID and Client Secret and fill back on TeamCity Server popup

• Click on Disable restricting authentication to specified GitHub.com organization, only if you want to restrict

• Don't forget to configure default roles first. Try to define a role with minimum permissions