login
and registration
. This redirect url will be used once the OAuth Provider calls the Streambird Callback URL we provided to you during the OAuth Connection setup.
For security reasons, we only allow you to use redirect URL preconfigured with Streambird to ensure that we redirect your users to redirect_urls
you whitelisted with us once we receive the callback request from the OAuth Provider.
OAuth style login UI
redirect=true
parameter, we allow you to embed a single static URL for your button and Streambird API will automatically redirect the browser to the generated OAuth Login URL for the OAuth provider. For example
redirect_url
yourself and handle the redirect in your own frontend logic, do the following
redirect_url
that you can use to initiate the Google OAuth flow.
redirect_url
into any button that initiates a Google OAuth flow.
Once the Google OAuth flow has begun, the user will see the Google login screen like below.
Sign in with Google
registration
or login
Redirect URL you setup depending on whether it is a new user or an existing user on the Streambird Platform under your App.
Once you have extracted the token generated by Streambird in your Redirect URL, verify the token against Streambird Auth API like below.
ApiKey
OAuthSession
object with provided info from the idp (identity provider) and also the internal Streambird user_id
(see example response below).
session_expires_in
parameter like the following.
session
object with session_token
and session_jwt
like the following response. Your can read more about Session management here on how to leverage Streambird’s Session management for multifactor authentication flow.
We recommend ensuring that you store our auto generated User ID from the response into your database/backend in a column or field against that user (as long as you can associate your user with the auto generated ID returned by Streambird). Streambird will ensure that each email is ONLY attached to a single user at any time.
If you have previously associated our Streambird user_id
with your users in your app, you are now done and you can safely authenticate the user by issuing a valid session or a JWT token!
However, if you have not previously attached the user_id
to your users table for example, you can also use our GetIdentityUser
endpoint to retrieve the emails
and phone_numbers
attached to the user using the user_id
returned.
user_id
from Streambird to your User entry in your own database and issue a valid session or JWT token or if you are using Streambird session management, return our session_token
or session_jwt
.