Ruby on Rails
Adicione autenticação ao seu app Ruby on Rails com o Clowk em 5 minutos: instale a gem, monte a engine, proteja controllers e use com Hotwire e Turbo.
Instale a gem
gem 'clowk'bundle installConfiguração
Clowk.configure do |config|
config.publishable_key = ENV['CLOWK_PUBLISHABLE_KEY']
config.secret_key = ENV['CLOWK_SECRET_KEY']
endCLOWK_PUBLISHABLE_KEY=pk_live_...
CLOWK_SECRET_KEY=sk_live_...Monte a engine
Rails.application.routes.draw do
mount Clowk::Engine => '/clowk'
endIsso adiciona /clowk/sign_in, /clowk/sign_up, /clowk/sign_out e /clowk/oauth/callback.
Inclua o Authenticable
class ApplicationController < ActionController::Base
include Clowk::Authenticable
endProteja seus controllers
class DashboardController < ApplicationController
before_action :authenticate_clowk!
def index
@user = current_clowk
end
endauthenticate_clowk! verifica o JWT da sessão. Se for inválido, redireciona para a página de login do Clowk (ou retorna 401 em requisições JSON).
current_clowk retorna um objeto Clowk::Current:
current_clowk.id # UUID do usuário
current_clowk.email # "[email protected]"
current_clowk.name # "Jane Doe"
current_clowk.avatar_url # "https://..."
current_clowk.provider # "google"Proteja actions específicas
class PostsController < ApplicationController
before_action :authenticate_clowk!, only: [:create, :update, :destroy]
def index
@posts = Post.all
end
def create
@post = Post.create!(
title: params[:title],
author_email: current_clowk.email,
author_id: current_clowk.id
)
redirect_to @post
end
endControllers só de API
class Api::V1::BaseController < ActionController::API
include Clowk::Authenticable
before_action :authenticate_clowk!
endViews com Hotwire e Turbo
<nav>
<% if clowk_signed_in? %>
<span>Hello, <%= current_clowk.name %></span>
<%= link_to "Sign out", clowk.sign_out_path, data: { turbo_method: :delete } %>
<% else %>
<%= link_to "Sign in", clowk.sign_in_path %>
<%= link_to "Sign up", clowk.sign_up_path %>
<% end %>
</nav>Próximos passos
- Integração completa com Rails — todas as opções de configuração, cliente SDK e uso avançado
- Como a autenticação funciona — o fluxo OAuth em detalhes
Hono
Guia completo de autenticação com Clowk no Hono: clowkMiddleware, requireAuth, o contexto auth e deploy em Cloudflare Workers, Bun, Deno e Node.js.
React
Adicione autenticação a um app React com o Clowk: defina sua publishable key, envolva o app no ClowkProvider e use os botões de login e o hook useAuth.