Struct Auth

pub struct Auth { /* private fields */ }

Auth クライアント

Implementations

impl Auth

pub fn new( url: &str, key: &str, http_client: Client, options: AuthOptions, ) -> Self

新しい Auth クライアントを作成

pub fn init_admin(&mut self, service_role_key: &str) -> &Self

管理者用APIクライアントを初期化

引数

• service_role_key - サービスロールキー（重要: クライアント側では使用せず、サーバー側でのみ使用する）

例

let auth = auth.init_admin("your-service-role-key");

pub fn admin(&self) -> Option<&AdminAuth>

管理者用APIクライアントを取得

例

if let Some(admin) = auth.admin() {
    // Use admin API here
    // let users = admin.list_users(None, None).await?;
}

pub async fn sign_up( &self, email: &str, password: &str, ) -> Result<Session, AuthError>

ユーザー登録

pub async fn sign_in_with_password( &self, email: &str, password: &str, ) -> Result<Session, AuthError>

メール・パスワードでログイン

pub fn get_session(&self) -> Option<Session>

現在のセッションを取得

pub async fn get_user(&self) -> Result<User, AuthError>

現在のユーザーを取得

pub async fn refresh_session(&self) -> Result<Session, AuthError>

セッションをリフレッシュ

pub async fn sign_out(&self) -> Result<(), AuthError>

サインアウト

pub async fn reset_password_for_email( &self, email: &str, ) -> Result<(), AuthError>

パスワードリセットメールの送信

pub fn get_oauth_sign_in_url( &self, provider: OAuthProvider, options: Option<OAuthSignInOptions>, ) -> String

OAuth プロバイダを通じたサインインのためのURL生成

pub async fn sign_in_with_oauth( &self, provider: OAuthProvider, options: Option<OAuthSignInOptions>, ) -> Result<String, AuthError>

OAuthで認証をリクエスト

pub async fn exchange_code_for_session( &self, code: &str, ) -> Result<Session, AuthError>

OAuthコールバックからのコードを処理してセッション取得

pub async fn sign_in_with_password_mfa( &self, email: &str, password: &str, ) -> Result<Result<Session, MFAChallenge>, AuthError>

MFAで保護されたサインイン - 最初のステップ（パスワードでの認証）

このメソッドは通常のサインインプロセスと同様ですが、ユーザーが MFAを有効化している場合は、次のステップで検証が必要なチャレンジを返します。

pub async fn verify_mfa_challenge( &self, challenge_id: &str, code: &str, ) -> Result<Session, AuthError>

MFAチャレンジの検証 - 第二ステップ（コードによる検証）

pub async fn enroll_totp(&self) -> Result<TOTPSetupInfo, AuthError>

MFAファクターを登録する

pub async fn verify_totp( &self, factor_id: &str, code: &str, ) -> Result<MFAFactor, AuthError>

TOTP MFAファクターを検証して有効化

pub async fn list_factors(&self) -> Result<Vec<MFAFactor>, AuthError>

ユーザーの登録済みMFAファクター一覧を取得

pub async fn unenroll_factor(&self, factor_id: &str) -> Result<(), AuthError>

MFAファクターを無効化（削除）

pub async fn sign_in_anonymously(&self) -> Result<Session, AuthError>

匿名認証でサインイン

pub async fn send_confirm_email_request( &self, email: &str, options: Option<EmailConfirmOptions>, ) -> Result<(), AuthError>

メール確認のリクエストを送信する

Arguments

• email - 確認メールを送信するメールアドレス
• options - オプション設定（リダイレクトURLなど）

Example

let options = EmailConfirmOptions {
    redirect_to: Some("https://example.com/confirm-success".to_string()),
};

auth.send_confirm_email_request("user@example.com", Some(options)).await?;

pub async fn verify_email(&self, token: &str) -> Result<Session, AuthError>

メール確認トークンを検証する

Arguments

• token - メール確認用のトークン（確認リンクから取得）

Example

let session = auth.verify_email("confirmation-token-from-email").await?;
println!("Email verified for user: {:?}", session.user.email);

pub async fn verify_password_reset( &self, token: &str, new_password: &str, ) -> Result<Session, AuthError>

パスワードリセット後にリセットトークンを検証する

Arguments

• token - パスワードリセット用のトークン（リセットリンクから取得）
• new_password - 新しいパスワード

Example

let session = auth.verify_password_reset("reset-token-from-email", "new-secure-password").await?;
println!("Password reset for user: {:?}", session.user.email);

pub async fn send_verification_code( &self, phone: &str, ) -> Result<PhoneVerificationResponse, AuthError>

pub async fn verify_phone_code( &self, phone: &str, verification_id: &str, code: &str, ) -> Result<Session, AuthError>

電話番号と検証コードでサインイン