What is Okta?

From the Okta website:

Okta is the foundation for secure connections between people and technology. It’s a service that gives employees, customers, and partners secure access to the tools they need to do their most important work.

Okta is an Identity and Single Sign-On (SSO) solution for applications and Cloud entities. It allows Sourcegraph to consolidate authentication and authorization to applications we use daily through a single dashboard and ensure a consistent, secure, and auditable login experience for all our Sourcegraph team members.

Current implementation status

Please see our Okta Project Plan for relevant timelines on app-specific and team-specific Okta integrations.

You should have received an activation email, if you haven’t please let #it-tech-ops know and we can resend the invite.

How is Sourcegraph using Okta?

Sourcegraph is using Okta for a few key goals:

  • Secure access to SaaS systems
  • Faster onboarding process
  • Consolidated & automated system access

What will be the benefits to me using Okta as a user?

  • A single dashboard that is provided to all users, with all the applications you need in a single place
  • The ability to request access to applications from within the dashboard
  • No more long list of complicated or insecure passwords
  • Managed SSO and Multi-Factor Authentication (MFA) that learns and adapts to your login patterns
  • Transparent security controls with a friendly user experience

What are the benefits to me as an application administrator to using Okta?

  • Automated provisioning and group management
  • Ability to transparently manage shared credentials to web applications without disclosing the credentials to users
  • Centralized access for users, making it easy to add, remove and change the application profile without the need to update all users.

How do I get my Okta account set up?

All Sourcegraph team members will have an Okta account set up as part of their onboarding process. Okta activation emails are valid for 7 days.

Expect the sign-up process to take around 10 minutes. You will need to create login credentials, and set up Okta Verify on your mobile and/or desktop device for MFA. Okta Verify is available on iOS, Android, and Windows devices. You can always use 1Password’s one-time passcode feature to host your MFA codes, if you would rather.

Contact #it-tech-ops if you need assistance setting this up.

Can I use a different MFA option other than Okta Verify?

Yes, we will be enabling TOTP and YubiKeys in addition to Okta Verify as our three MFA options for Okta. Once we have successfully configured them you will see them listed when you set up 2FA. You can set up Okta Veify (or use 1Password’s one-time passcode with Okta Verify) first and then once enable switch to TOTP or YubiKeys when they are ready.

For YubiKey set up:

  1. Follow these instructions
  2. Send #it-tech-ops the generated CSV

I forgot my password/my login doesn’t work, what do I do?

There is a “need help signing in?” button on the login screen. If you expand this there is a link to an automated password reset process via email. We recommend that you store your Okta password in 1Password as well as your Security Questions there.

If you forgot your password to Okta you won’t have access to your Sourcegraph google account BUT you can also use your secondary/personal email address (as it is entered in BambooHR) to reset your password:

  1. Go to the our Sourcegraph Okta Login page
  2. Forgot Password
  3. Enter your personal email address
  4. Reset via Email
  5. Go to your personal email account
  6. Follow the directions from Okta for resetting you password

I forgot my Security Questions, how do I reset my password?

Ask #it-help-ops for a temporary password to be issued. You will be given a temporary password at which point you can reset your access.

I changed my phone and now can’t do MFA, what do I do?

No worries! You can easily reset your own MFA code for Okta if you did not wipe/return your old phone yet.

  1. Sign in to your Okta webpage by going to https://www.sourcegraph.okta.com on your old phone
  2. Use your email, password, and the MFA code on your old phone
  3. Once you’re on the Okta webpage click on your name and then click settings
  4. Scroll down until you see “Extra Verification”, once you’re there click “remove” to disable that instance of Okta Verify
  5. Configure the new MFA code on your new phone

Lost all your MFA Factors? Ask #it-tech-ops for an MFA Reset. Once your Factors have been reset, please set up MFA again.

My Okta account has been locked out because of failed attempts, what do I do?

Being locked out of Okta will also mean you are locked out of Google and Slack. Tech-Ops-Admin@sourcegraph.com will receive an email saying you have been lock out but please send us a confirmation email from your personal email account so we know it was you. As a precaution, you will also need to change your Okta Password.

Why isn’t an application I need available in Okta?

Most likely because that system doesn’t offer an SSO option or because we need to upgrade in order to enable the feature. Please feel free to ask us about it in the #it-tech-ops channel.

I have an application that uses a shared password for my team, can I move this to Okta?

Yes you can! More on this later…

I’m getting asked to MFA authenticate a lot, is that normal?

The way we have Okta set-up should require you to authenticate once with MFA every 12 hours. It’s recommended that you log in via the Okta dashboard at the beginning of your day, and then use either the dashboard or the Okta plugin for applications during your workday.

For some applications, we will enforce an additional MFA step periodically because of the sensitivity of the data in them.

If you are having problems with being asked for multiple MFA authentications during the day, please contact #it-tech-ops and we can look into it.

Where do I go if I have any questions?

For Okta help, setup, and integration questions: #it-tech-ops Slack channel or tech-ops-admin@sourcegraph.com

Who are the Okta Super Admins?

Nate Tang, Tech Ops, nate@sourcegraph.com

Maureen Loughrey, Tech Ops, maureen.loughrey@sourcegraph.com

Nicky Van Maanen, Tech Ops, nicky@sourcegraph.com