Open apps from the Account

Users can open your app from their Sentra Account. Sentra opens your app’s login URL, and your app starts a sign-in as usual.

Where your app appears

Once a user has signed in to your app and given consent, your app appears in two places:

  • Aplikasi terhubung (connected apps) in the Sentra Account, with a Buka aplikasi (open app) button.
  • The Buka aplikasi launcher in the side menu.

Only active apps the user has consented to are shown, most recently used first.

Set the login URL

Open the app in the console and fill in the login URL (URL masuk aplikasi). It must use https (except localhost during development) and can’t contain a fragment (#). Its domain is also shown under your app’s name on Sentra’s sign-in page and in the connected apps list.

Without a login URL, the app still appears in the list but shows Tidak ada tautan (no link) and can’t be opened.

What the address must do

The login URL must start a Sentra sign-in, exactly like the Sign in with Sentra button. Usually it’s the same redirect route:

https://api.belajar.contoh.id/auth/sso/redirect

What happens when the user clicks it:

  1. Sentra opens your login URL.
  2. Your app generates state and PKCE, then sends the user to /authorize.
  3. Because the Sentra session is still valid and consent was given, Sentra returns straight to your Redirect URI with a code, without asking for a password. The account chooser only appears when several accounts are signed in on that browser.
  4. Your callback exchanges the code and starts the session, as usual.

The Sentra session lasts 24 hours and isn’t extended by activity. After that the user is asked to sign in again.

Sentra never sends a code or user data to the login URL. Don’t accept a token or identity from URL parameters on this route; always start the sign-in from your own app, with a state you generated.

If the user already has a session in your app, this route may send them straight to your home page without going to Sentra.

Removing an app from the list

Users can click Hapus dari daftar (remove from list) in Aplikasi terhubung. This only hides the app from that user’s list and launcher:

  • Your app’s access isn’t revoked. The consent stays, and the session in your app doesn’t end.
  • The app reappears in the list the next time the user signs in to your app.

To sign out of your app, users sign out in your app itself. Signing out of Sentra doesn’t end the session in your app either, and the other way round.