DingTalk サインインを Expo (React Native) で構築する方法

新しい友達のために:

Logto は、モダンなアプリや SaaS 製品向けに設計された Auth0 の代替です。 Cloud とオープンソースの両方のサービスを提供し、アイデンティティと管理 (IAM) システムを迅速に立ち上げるのに役立ちます。認証 (Authentication)、認可 (Authorization)、マルチテナント管理をすべて一つにまとめて楽しんでください。

Logto Cloud で無料の開発テナントから始めることをお勧めします。これにより、すべての機能を簡単に探索できます。

この記事では、Expo (React Native) と Logto を使用して、DingTalk サインイン体験（ユーザー認証 (Authentication)）を迅速に構築する手順を説明します。

前提条件

稼働中の Logto インスタンス。紹介ページをチェックして始めてください。
Expo (React Native) の基本的な知識。
使用可能な DingTalk アカウント。

Logto でアプリケーションを作成する

Logto は OpenID Connect (OIDC) 認証 (Authentication) と OAuth 2.0 認可 (Authorization) に基づいています。これは、複数のアプリケーション間でのフェデレーテッドアイデンティティ管理をサポートし、一般的にシングルサインオン (SSO) と呼ばれます。

あなたのネイティブアプリアプリケーションを作成するには、次の手順に従ってください：

Logto コンソールを開きます。「Get started」セクションで、「View all」リンクをクリックしてアプリケーションフレームワークのリストを開きます。あるいは、Logto Console > Applications に移動し、「Create application」ボタンをクリックします。
開いたモーダルで、左側のクイックフィルターチェックボックスを使用して、利用可能なすべての "ネイティブアプリ" フレームワークをフィルタリングするか、"ネイティブアプリ" セクションをクリックします。"Expo" フレームワークカードをクリックして、アプリケーションの作成を開始します。
アプリケーション名を入力します。例：「Bookstore」と入力し、「Create application」をクリックします。

🎉 タダーン！Logto で最初のアプリケーションを作成しました。詳細な統合ガイドを含むお祝いページが表示されます。ガイドに従って、アプリケーションでの体験を確認してください。

Expo SDK を統合する

ヒント:

次のデモンストレーションは Expo ~50.0.6 上で構築されています。
サンプルプロジェクトは、私たちの SDK リポジトリで利用可能です。

インストール

お気に入りのパッケージマネージャーを使用して Logto SDK とピア依存関係をインストールします：

npm
Yarn
pnpm

npm i @logto/rn
npm i expo-crypto expo-secure-store expo-web-browser @react-native-async-storage/async-storage

yarn add @logto/rn
yarn add expo-crypto expo-secure-store expo-web-browser @react-native-async-storage/async-storage

pnpm add @logto/rn
pnpm add expo-crypto expo-secure-store expo-web-browser @react-native-async-storage/async-storage

@logto/rn パッケージは Logto の SDK です。残りのパッケージはそのピア依存関係です。これらは直接の依存関係としてリストされることができませんでした。なぜなら、Expo CLI はネイティブモジュールのすべての依存関係がルートプロジェクトの package.json に直接インストールされることを要求するからです。

注記:

ベア React Native アプリにこれをインストールする場合は、これらの追加のインストール手順に従う必要があります。

Logto プロバイダーを初期化する

LogtoProvider をインポートして使用し、Logto コンテキストを提供します：

App.tsx
import { LogtoProvider, LogtoConfig } from '@logto/rn';

const config: LogtoConfig = {
  endpoint: '<your-logto-endpoint>',
  appId: '<your-application-id>',
};

const App = () => (
  <LogtoProvider config={config}>
    <YourAppContent />
  </LogtoProvider>
);

詳細に入る前に、エンドユーザーの体験について簡単に説明します。サインインプロセスは次のように簡略化できます：

あなたのアプリがサインインメソッドを呼び出します。
ユーザーは Logto のサインインページにリダイレクトされます。ネイティブアプリの場合、システムブラウザが開かれます。
ユーザーがサインインし、あなたのアプリにリダイレクトされます（リダイレクト URI として設定されています）。

この認証 (Authentication) プロセスは OpenID Connect (OIDC) プロトコルに従い、Logto はユーザーのサインインを保護するために厳格なセキュリティ対策を講じています。
複数のアプリがある場合、同じアイデンティティプロバイダー (Logto) を使用できます。ユーザーがあるアプリにサインインすると、Logto は別のアプリにアクセスした際に自動的にサインインプロセスを完了します。

リダイレクトベースのサインインの理論と利点について詳しく知るには、Logto サインイン体験の説明を参照してください。

Logto Console のアプリケーション詳細ページに移動します。ネイティブリダイレクト URI（例：io.logto://callback）を追加し、「保存」をクリックします。

iOS の場合、ASWebAuthenticationSession クラスがリダイレクト URI を登録されているかどうかに関係なくリッスンするため、リダイレクト URI スキームは実際には重要ではありません。
Android の場合、リダイレクト URI スキームは Expo の app.json ファイルに記入する必要があります。例えば：
app.json
```
{
  "expo": {
    "scheme": "io.logto"
  }
}
```

さて、アプリに戻って、useLogto フックを使用してサインインとサインアウトを行うことができます：

App.tsx
import { useLogto } from '@logto/rn';
import { Button } from 'react-native';

const Content = () => {
  const { signIn, signOut, isAuthenticated } = useLogto();

  return (
    <div>
      {isAuthenticated ? (
        <Button title="Sign out" onPress={async () => signOut()} />
      ) : (
        // リダイレクト URI を自分のものに置き換えてください
        <Button title="Sign in" onPress={async () => signIn('io.logto://callback')} />
      )}
    </div>
  );
};

チェックポイント: アプリケーションをテストする

これで、アプリケーションをテストできます：

アプリケーションを実行すると、サインインボタンが表示されます。
サインインボタンをクリックすると、SDK がサインインプロセスを初期化し、Logto のサインインページにリダイレクトされます。
サインインすると、アプリケーションに戻り、サインアウトボタンが表示されます。
サインアウトボタンをクリックして、トークンストレージをクリアし、サインアウトします。

DingTalk コネクターを追加する

迅速なサインインを有効にし、ユーザーコンバージョンを向上させるために、アイデンティティプロバイダー (IdP) として Expo を接続します。Logto ソーシャルコネクターは、いくつかのパラメーター入力を許可することで、この接続を数分で確立するのに役立ちます。

ソーシャルコネクターを追加するには、次の手順に従ってください：

Console > Connectors > Social Connectors に移動します。
「Add social connector」をクリックし、「DingTalk」を選択します。
README ガイドに従い、必要なフィールドを完了し、設定をカスタマイズします。

注記:

インプレースコネクターガイドに従っている場合は、次のセクションをスキップできます。

DingTalk OAuth app を設定する

DingTalk Open Platform で Web アプリを作成する

ヒント：すでに完了しているセクションはスキップできます。

DingTalk 開発者アカウントを登録する

DingTalk 開発者アカウントをお持ちでない場合は、 DingTalk Open Platform で登録してください。

アプリケーションを作成する

DingTalk Open Platform の「アプリケーション開発」>「社内アプリケーション」>「DingTalk アプリケーション」で「アプリケーション作成」をクリック
アプリケーション名 と説明を入力し、「保存」をクリック
左側のナビゲーションバーで「開発設定」>「セキュリティ設定」を選択し、「リダイレクト URL」 ${your_logto_origin}/callback/${connector_id} を設定します。connector_id は管理コンソールで該当コネクターを追加後、コネクター詳細ページで確認できます
左側のナビゲーションバーで「基本情報」>「資格情報と基本情報」を選択し、Client ID と Client Secret を取得します

権限を設定する

「開発設定」>「権限管理」で Contact.User.Read および Contact.User.mobile 権限を選択し、認可します

アプリケーションをリリースする

左側のナビゲーションバーで「アプリケーションリリース」>「バージョン管理とリリース」を選択し、最初のバージョンを作成してリリースし、Client ID と Client Secret を有効化します

注記:

アプリケーションがバージョンをリリースしない場合、取得した「Client ID」と「Client Secret」は使用できず、リクエストも失敗します。

コネクターを設定する

前セクションで取得した OAuth アプリ詳細ページの Client ID（旧 AppKey および SuiteKey） と Client Secret（旧 AppKey および SuiteKey） を clientId および clientSecret フィールドに入力します。

scope は現在 2 つの値をサポートしています：openid および openid corpid。openid は認可後にユーザーの userid を取得でき、openid corpid はログイン時に選択したユーザーの id と組織の id の両方を取得できます。値はスペース区切りで指定してください。注意：URL エンコードが必要です。

設定タイプ

名前	型
clientId	string
clientSecret	string
scope	string

DingTalk コネクターをテストする

これで完了です。DingTalk コネクターが利用可能になっているはずです。サインイン体験でコネクターを有効化するのを忘れずに。

DingTalk Web コネクターを有効化したら、アプリに再度サインインして動作を確認できます。

注記:

開発中は DingTalk Open Platform の利用規約および開発ガイドラインを厳守してください。

サポート

ご質問やさらなるサポートが必要な場合は、 DingTalk 開発者ドキュメントをご覧いただくか、DingTalk テクニカルサポートまでお問い合わせください。

設定を保存する

Logto コネクター設定エリアで必要な値をすべて記入したことを確認してください。「保存して完了」または「変更を保存」をクリックすると、DingTalk コネクターが利用可能になります。

ソーシャルコネクターを正常に作成したら、サインイン体験で「DingTalk で続行」ボタンとして有効にすることができます。

Console > サインイン体験 > サインアップとサインインに移動します。
（オプション）ソーシャルログインのみが必要な場合は、サインアップ識別子に「該当なし」を選択します。
設定済みの DingTalk コネクターを「ソーシャルサインイン」セクションに追加します。

テストと検証

Expo (React Native) アプリに戻ります。これで DingTalk を使用してサインインできるはずです。お楽しみください！

さらなる読み物

エンドユーザーフロー：Logto は、MFA やエンタープライズシングルサインオン (SSO) を含む即時使用可能な認証 (Authentication) フローを提供し、アカウント設定、セキュリティ検証、マルチテナント体験の柔軟な実装のための強力な API を備えています。

認可 (Authorization)：認可 (Authorization) は、ユーザーが認証 (Authentication) された後に行えるアクションやアクセスできるリソースを定義します。ネイティブおよびシングルページアプリケーションの API を保護し、ロールベースのアクセス制御 (RBAC) を実装する方法を探ります。

組織 (Organizations)：特にマルチテナント SaaS や B2B アプリで効果的な組織機能は、テナントの作成、メンバー管理、組織レベルの RBAC、およびジャストインタイムプロビジョニングを可能にします。

顧客 IAM シリーズ：顧客（または消費者）アイデンティティとアクセス管理に関する連続ブログ投稿で、101 から高度なトピックまでを網羅しています。

Logto でアプリケーションを作成する​

Expo SDK を統合する​

インストール​

Logto プロバイダーを初期化する​

サインインとサインアウトを実装する​

リダイレクトベースのサインインについて​

チェックポイント: アプリケーションをテストする​

DingTalk コネクターを追加する​

DingTalk OAuth app を設定する​

DingTalk Open Platform で Web アプリを作成する​

DingTalk 開発者アカウントを登録する​

アプリケーションを作成する​

権限を設定する​

アプリケーションをリリースする​

コネクターを設定する​

設定タイプ​

DingTalk コネクターをテストする​

サポート​

設定を保存する​

サインイン体験で DingTalk コネクターを有効にする​

テストと検証​

さらなる読み物​