Skip to content

docs: add callback controller / routes / login walkthrough - #2

Merged
jgnagy merged 1 commit into
mainfrom
docs/callback-integration
Aug 30, 2026
Merged

jgnagy merged 1 commit into
mainfrom
docs/callback-integration

Conversation

@jgnagy

@jgnagy jgnagy commented Aug 30, 2026 •

Copy link
Copy Markdown
Member

Summary

Adds the app-integration sections the README was missing:

  • Store the credentials — config/authify.yml via Rails.application.config_for
  • Create the initializer — OmniAuth middleware with the strategy's
    org-scoped options(site + organization)
  • Create the callback controller — what's in
    request.env["omniauth.auth"] at that point (ID token already verified)
    and a failure action
  • Add routes — callback + failure wiring, and the POST-only
    /auth/authify request phase
  • Logging in — button_to example that satisfies OmniAuth 2.x CSRF,
    plus a note that prompt is forwarded to Authify
  • Sinatra/Rack section retained

Checks

  • All internal README anchors resolve
  • Code fences balanced
  • rubocop / spec / rbs / yard gates green

Adds Rails-oriented sections covering the full integration path:
credential storage via config/authify.yml, the middleware
initializer, a callback/failure controller, routes, and a
login-button example — plus the Sinatra path and notes about the
POST-only request phase, the auto-verified ID token, and prompt
forwarding.
@jgnagy
jgnagy force-pushed the docs/callback-integration branch from 8067a04 to 4ffbdcd Compare August 30, 2026 20:36
@jgnagy
jgnagy merged commit b085bb9 into main Aug 30, 2026
6 checks passed
@jgnagy
jgnagy deleted the docs/callback-integration branch August 30, 2026 20:44
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant