Sinch Access Keys

[Shahzad_Ismail]

Sinch uses Access keys (tokens) to authenticate users. These tokens can be obtained from an OAuth2 token endpoint, which supports the client_credentials flow where a client_id and client_secret are used to authenticate the calling party.

An access key is comprised of:

• KEY ID - The client_id is referred to as KEY ID and is your API key. When sending a call through the API, it lets us know which account to bill.
  
  
• KEY SECRET - The client_secret is referred to as the KEY SECRET and is an extra layer of security which is only visible when you create an access key.
  
  

Important:

• When you create an Access key, note down your KEY SECRET carefully as this is only displayed when you create the Access key. If you lose your KEY SECRET (formerly called the secret ID) you will need to generate a new access key.
  
  
• SMS Messaging uses a Service Plan ID and API Token for authentication. Read the SMS Service Plan IDs and API Tokens article to learn more.

Where can I find my Access Keys (KEY ID and KEY SECRET)?

Log in to the Sinch Customer Dashboard.

• If you're using the beta version of our Customer Dashboard, click your profile icon then click Access Keys: 
  
  
  
  The Account menu is displayed on the left. Click the Access Keys option:
  
  
  
  
• If you are using the legacy dashboard, click Settings on the left menu, then click Access keys:
  
  

The Access keys page is displayed. This page shows your project(s) and corresponding Project ID(s) and a list of your Access keys and the corresponding KEY IDs.

How do I create new Access Keys?

To create a new Access Key from the Access keys page:

1. In the Access key list section, click NEW KEY to create a new key. The New Access Key form is displayed:
   
   
   
   Enter a display name for your key and click CONFIRM.
   
   
2. The Key is created and the Key ID & Key Secret form is displayed:
   
   
   
   Copy the Key ID and Key Secret. Click CONFIRM.
   
   Important! – You must copy and store the Key Secret that is generated. You won't be able to retrieve it again once you’ve created the key.
   
   
3. You are returned to the Access Keys page where your new key is displayed in the Access key list section:
   
   
   
   Note: The KEY SECRET is only displayed on initial creation of a new Access key.
   
   

If you have any questions, contact Sinch or to reach out to your Sinch Account Manager. 

[#2]

Following a successful early release for selected customers, on 3 June 2024 Sinch will continue to roll out a new single sign-on login experience that will allow you to seamlessly login to any existing Sinch services that you may use. The best part is that your existing login credentials (for Sinch Dashboard or Mailgun Control panel) will be migrated across to create your new Sinch ID.

What is Sinch ID?

Your Sinch ID is a single user identity for all Sinch products and services. With Sinch ID, you can use one set of login credentials and two-factor authentication (2FA) to login to multiple dashboards within our communications ecosystem. We are starting with the Sinch Dashboard and the Mailgun Control Panel, where using the Sinch ID you can now use the same credentials to access both platforms. 

Your Sinch ID will be managed in its own application (https://id.sinch.com), where you can:

•        Enroll in 2FA (SMS or App)
•        Obtain recovery codes
•        Change your password.

How does this impact me?

Important: This change will not affect all users and is being rolled out in a phased manner. 

As an existing customer, you do not have to do anything – your existing email/password and 2FA will be automatically migrated to a Sinch ID.

You will however, notice a different sequence of login pages when you try to log in. But don’t worry, we will guide you step-by-step through the new experience below. 

The New Login Experience!

The new login experience is straightforward – we will walk you through the steps below:

1. Login to the Sinch Customer Dashboard:
   
   
   
   Please enter your email address as normal. Click CONTINUE.
   
2. Your email address will be verified:
   
   
   
   Enter your existing password. It's the same one you've been using to login to the Sinch Dashboard. In other words, although the login experience is a bit different now, your login password has not changed.
   
   Click Continue.
   
   
3. The Verify your identity dialog is displayed:
   
   
   
   Sinch uses Two Factor Authentication (2FA) for added security. A text message will be sent to your verified phone number screen containing your 2FA token code.
   
   Enter the 6-digit token and click Continue.
   
   
4. The first time you log using the new SInch ID, your recovery code is displayed:
   
   
   
   Your recovery code is important as it allows you to verify your account if you lose your 2FA credentials or your 2FA phone. Please copy your recovery code and store it somewhere safe.
   
   Click the check box to confirm you have copied the code and click Continue.
   
   Note: The recovery code is only displayed the first time you log into the Sinch Dashboard using the new SInch ID.
   
   
5. You'll now be logged in and taken to the Sinch Dashboard Welcome page. 

Got Questions?

If you have any questions or concerns, please raise a ticket with the Sinch Support team who will be able happy to assist you!