Skip to main content

Mobile Quickstart Webview Or Browser

Doc type: Tutorial

Goal and expected outcome​

Your mobile app launches the hosted auth portal in a webview or system browser, completes login, and returns to an HTTPS landing page you control.

Prerequisites and setup​

  • You can open web content from the mobile app (webview or external browser).
  • You have an HTTPS landing page on *.yoyogroup.com to receive the redirect.
  • Your redirect target is HTTPS (the portal only allows HTTPS redirects).

Step 1: Launch hosted auth​

Open the hosted auth portal with a redirect back to your HTTPS landing page.

https://auth.yoyogroup.com/?redirectUrl=<encoded https return URL>

Step 2: Handle the HTTPS redirect​

After sign-in, the portal redirects to your HTTPS landing page. From there you can:

  • Display a signed-in confirmation.
  • Continue in a web experience on the same domain.
  • Trigger app navigation using platform-specific universal links.

Step 3: Access session data via a backend​

Mobile clients cannot read the HttpOnly cookies directly. If you need server-side access to the session, use a backend on *.yoyogroup.com that reads the shared cookies and exchanges data with your mobile app.

Verify the result​

  • The HTTPS landing page loads after login.
  • The yoyo_auth_access_token cookie is present for .yoyogroup.com.

Example implementations​

For complete working examples, see:

  • examples/yoyo-auth-nextjs-example - Next.js integration example
  • examples/yoyo-auth-spa-example - React + Vite SPA example