Tornevall Networks

← Back to docs

OAuth-endpoints

Language: SV | EN | SV

OAuth-endpoints

Denna sida dokumenterar OAuth-endpoints som anvands av Tools webbintegrationer.

Slack OAuth

Starta OAuth-flode

  • Route name: oauth.slack.start
  • Path: /oauth/slack/start
  • Method: GET eller POST
  • Auth: auth:web

Startar Slack OAuth-flodet och redirectar till Slack oauth/v2/authorize.

OAuth-callback

  • Route name: oauth.slack.callback
  • Path: /oauth/slack/callback
  • Method: GET
  • Auth: auth:web

Slack redirectar tillbaka hit med code och state.

Callback URL-helper

  • Route name: oauth.slack.callback-url
  • Path: /oauth/slack/callback-url
  • Method: GET
  • Auth: auth:web

Returnerar aktuell callback-URL i JSON:

{
  "callback_url": "https://tools.tornevall.com/oauth/slack/callback"
}

SoundCloud OAuth

Starta OAuth-flode

  • Route name: oauth.soundcloud.start
  • Path: /oauth/soundcloud/start
  • Method: POST
  • Auth: auth:web

Forvantad payload:

{
  "provider_app_id": 1,
  "target_owner_type": "system",
  "target_owner_id": null
}

OAuth-callback

  • Route name: oauth.soundcloud.callback
  • Path: /oauth/soundcloud/callback
  • Method: GET
  • Auth: auth:web

Tar emot provider-callback (state, code, error, error_description).

Microsoft OAuth (delad Microsoft Graph-app)

Starta OAuth-flode

  • Föredragen route name: oauth.microsoft.start
  • Föredragen path: /oauth/microsoft/start
  • Äldre kompatibilitets-route name: oauth.microsoft_todo.start
  • Äldre kompatibilitets-path: /oauth/microsoft-todo/start
  • Method: POST
  • Auth: auth:web

Startar det delade Microsoft OAuth-flödet för den användare som är inloggad just nu.

Direkt auth-startlank

  • Föredragen route name: oauth.microsoft.start_link
  • Föredragen path: /oauth/microsoft/start-link
  • Äldre kompatibilitets-route name: oauth.microsoft_todo.start_link
  • Äldre kompatibilitets-path: /oauth/microsoft-todo/start-link
  • Method: GET
  • Auth: auth:web

Skapar en ny signerad Microsoft OAuth-state och skickar browsern direkt vidare till Microsoft från en vanlig klickbar URL.

OAuth-callback

  • Föredragen route name: oauth.microsoft.callback
  • Föredragen path: /oauth/microsoft/callback
  • Äldre kompatibilitets-route name: oauth.microsoft_todo.callback
  • Äldre kompatibilitets-path: /oauth/microsoft-todo/callback
  • Method: GET
  • Auth: publik callback-URL (den signerade OAuth-state:n styr fortfarande vilken användare/transaktion som får slutföras)

Tar emot provider-callback (state, code, error, error_description) och sparar den nuvarande Microsoft-kopplingen per användare som i dag används av Microsoft To Do. När den ursprungliga webbsessionen har försvunnit återskapar Tools nu rätt session från den signerade OAuth-state:n innan användaren skickas tillbaka till integrationssidan för Microsoft To Do.

API-helper för OAuth-start

  • Primär path: /api/microsoft/oauth/start
  • Äldre kompatibilitetsväg: /api/microsoft-todo/oauth/start
  • Method: GET
  • Auth: inloggad webbsession eller JWT bearer-token från POST /api/account/login

Returnerar en Microsoft-auktoriserings-URL för den autentiserade användaren tillsammans med den callback-URL som aktuell host förväntar sig.

Generisk Microsoft auth-statushelper

  • Path: /api/microsoft/auth/status
  • Method: GET
  • Auth: inloggad webbsession eller JWT bearer-token från POST /api/account/login

Returnerar delad Microsoft auth-/plattform-appstatus för den autentiserade användaren, inklusive callback-/start-URL:er och tenant/kontotypsdiagnostik som inte bara är knuten till Microsoft To Do-listor/uppgifter.

X-callbackplaceholder

Nuvarande X mention-bot slutför inte något webbläsarbaserat OAuth-utbyte. Den använder fortfarande statiska server-side X_BOT_*-credentials från .env.

Om du får X OAuth 2.0-klientuppgifter under appsetup ska de sparas i:

  • X_OAUTH2_CLIENT_ID
  • X_OAUTH2_CLIENT_SECRET
  • valfri X_OAUTH2_REDIRECT_URI

Om X-dashboarden också visar genererade OAuth 2.0 user-tokens ska de sparas i:

  • X_OAUTH2_ACCESS_TOKEN
  • X_OAUTH2_REFRESH_TOKEN

Dessa är reserverade för ett framtida callback-drivet OAuth2-flöde och är separata från de nuvarande OAuth1-liknande postningscredentials X_BOT_ACCESS_TOKEN och X_BOT_ACCESS_TOKEN_SECRET.

Tools exponerar nu ändå en publik callbackplaceholder så att det finns en riktig URL att ange när X-appkonfigurationen kräver ett callbackfält:

Callbackplaceholder

  • Route name: oauth.x.callback
  • Path: /oauth/x/callback
  • Method: GET
  • Auth: publik

Denna route fungerar just nu bara som informationssida och placeholder. Den byter ännu inte ut eller sparar X OAuth-tokens.

Callback URL-helper

  • Route name: oauth.x.callback-url
  • Path: /oauth/x/callback-url
  • Method: GET
  • Auth: publik

Returnerar JSON med aktuell beräknad X-callback-URL.

Redirect URL-guidning

For Slack-appkonfiguration, anvand:

  • Dev: https://tools.tornevall.com/oauth/slack/callback
  • Prod: https://tools.tornevall.net/oauth/slack/callback

Om SLACK_REDIRECT_URI ar satt anvands det vardet som effektiv redirect URI och ska registreras i Slack App settings.

For den delade Microsoft / Microsoft Graph-appkonfigurationen, registrera callbacken som matchar aktuell miljo:

  • Dev: https://tools.tornevall.com/oauth/microsoft/callback
  • Prod: https://tools.tornevall.net/oauth/microsoft/callback

Äldre callbackalias under /oauth/microsoft-todo/callback fungerar fortfarande, men den generiska /oauth/microsoft/callback-routen är nu det rekommenderade registreringsmålet för en delad Microsoft / Graph-app som senare också kan bära bredare integrationer, till exempel Microsoft Copilot-liknande flöden.

Om MICROSOFT_REDIRECT_URI ar satt blir det vardet den effektiva redirect URI:n och ska ocksa registreras i Microsoft Entra-appen. Äldre MICROSOFT_TODO_REDIRECT_URI accepteras fortfarande som kompatibilitetsalias.

Om du förväntar dig personliga Microsoft-konton (@outlook.com, @hotmail.com, @live.com) ska tenant normalt vara common eller consumers, och själva Azure-appregistreringen måste också vara aktiverad för personliga konton (MSA). Annars svarar Microsoft ofta med unauthorized_client.

För X-appregistrering, om du behöver fylla i ett callbackfält trots att nuvarande bot använder statiska credentials, använd:

  • Dev: https://tools.tornevall.com/oauth/x/callback
  • Prod: https://tools.tornevall.net/oauth/x/callback

Nar Microsoft To Do-plattformsappen inte ar miljohanterad kan den delade appkonfigurationen nu aven sparas fran /settings/integrations/microsoft-todo av en acknowledged admin. Sidan visar samma rekommenderade callback-URL tillsammans med additiv diagnostik om vilka plattformsappfalt som fortfarande saknas.