BrightMLS utilizes OAuth 2.0 and OpenID Connect to control authorization and authentication for the RESO Web API. OAuth 2.0 and OpenID Connect (OIDC) are industry standard protocols for user authentication and authorization.
Applying for Credentials
To obtain access to the BrightMLS Web API, you must first apply here. Once the process has been started and initial contract is completed, you will be provided test credentials to begin your integration.
Authentication with BrightMLS Web API requires the following, which are provided to you:
- Client ID
- Client Secret
- Authentication endpoint
Auth Endpoint
Method POST
https://brightmls-test.okta.com/oauth2/default/v1/tokenSample header
accept: application/json
content-type: application/x-www-form-urlencodedSample form body
grant_type: client_credentials
client_id: <client id>
client_secret: <client secret>Sample response
{
"token_type": "Bearer",
"expires_in": 3600,
"access_token": "eyJraWQiOiJlTkhHNW1nQ1RPUXZ2Xy1EcHN...",
"scope": "clientcred"
}Client Credentials flow
The Client Credentials flow is intended for server-side (confidential) client applications with no end user. Normally, this means machine-to-machine communication. The application must be server-side because it must be trusted with the client secret, and since the credentials are hard-coded, an actual end user can't use it. It involves a single, authenticated request to the /token endpoint, which returns an access token.
Once you have a received an access token, it must be included in all endpoint requests as a bearer token in the header.
Authorization: Bearer eyJraWQiOiJlTkhHNW1nQ1RPUXZ2Xy1EcHN...