Facebook authentication¶

Configuration¶

To use Facebook login with Hasura, create an app on Facebook at https://developers.facebook.com/.
In the newly created app page, obtain the “App ID” and “App Secret” values.
Now you need to configure the Hasura auth microservice with these credentials.
To configure, go to the conf/auth.yaml file inside your Hasura project.
Under facebook, set your clientId.

Note

The facebook key might be commented out. Make sure to uncomment it.

facebook:
  clientId: "String"
  clientSecret:
    secretKeyRef:
      key: auth.facebook.client_secret
      name: hasura-secrets

clientId: The app ID obtained when creating the application.
clientSecret: The app secret obtained when creating the application. As you see in the above code snippet, client secret is a reference to a hasura project secret called auth.facebook.client_secret. To add your client secret to hasura project secrets, run the following command from your project directory.
```
$ hasura secret update auth.facebook.client_secret
```

Web apps¶

For web apps, use the Facebook login for web Javascript SDK to integrate with Hasura auth.

See here on how to use it: https://developers.facebook.com/docs/facebook-login/web/

Mobile apps¶

For mobile apps, use the Facebook mobile SDKs to integrate with Hasura auth.

See here how to use it:

API¶

Login / signup¶

Use Facebook SDK from above to obtain the accessToken (or access_token) of the logged in Facebook user.

Once the access_token is obtained, send the access_token to the Hasura auth microservice:

POST auth.<cluster-name>.hasura-app.io/v1/login HTTP/1.1
Content-Type: application/json

{
  "provider" : "facebook",
  "data" : {
     "access_token": "String",
  }
}

If successful, this will return a response as follows:

HTTP/1.1 200 OK
Content-Type: application/json

{
  "auth_token": "b4b345f980ai4acua671ac7r1c37f285f8f62e29f5090306",
  "hasura_id": 79,
  "new_user": true,
  "hasura_roles": [
      "user"
  ]
}

If the user is a new user, new_user will be true, else false.
To check if the current user is logged in, make a call to: /v1/user/info.
To logout, make a call to /v1/user/logout.
To get the Hasura credentials of the current logged in user, /v1/user/info.

« previous | next »

Was this page helpful?