LINEミニアプリの認可フロー

Markdownで表示

LIFFアプリがユーザーの情報を取得したり、ユーザーにメッセージを送信したりするには、ユーザーがLIFFアプリに初めてアクセスする際に、「チャネル同意画面」において、対応する権限に同意する必要があります。

LINEミニアプリでは、「チャネル同意の簡略化」機能によって、ユーザーが簡略化に対する同意を初回のみ行うだけで、別のLINEミニアプリに初めてアクセスする際に「チャネル同意画面」をスキップし、すぐにLINEミニアプリの利用を開始できるようになります。

このページでは「チャネル同意の簡略化」機能と、それに基づく認可フローについて説明します。

「チャネル同意の簡略化」機能とは

「チャネル同意の簡略化」機能とは、ユーザーがLINEミニアプリに初めてアクセスする際に必要となる、権限への同意を簡略化する仕組みです。ユーザーが簡略化に一度同意すれば、別のLINEミニアプリでも権限に同意したとみなされます。以降初めてアクセスするLINEミニアプリ(※)では「チャネル同意画面」がスキップされ、すぐにLINEミニアプリの利用を開始できます。

ただし、LINEヤフー株式会社による個人情報保護方針に基づき、「チャネル同意の簡略化」機能で同意がスキップされる権限はユーザーIDの取得(openidスコープ)のみです。ユーザーのプロフィール情報の取得やメッセージ送信に必要な権限(profileスコープやchat_message.writeスコープなど)は、「チャネル同意の簡略化」機能の対象に含まれません。これらの追加の権限については、各LINEミニアプリ内で必要となったタイミングで「アクセス許可要求画面」が表示されます。詳しくは、「「アクセス許可要求画面」でopenidスコープ以外の権限を要求する」を参照してください。

「チャネル同意の簡略化」機能を有効にすると、ユーザーがより簡単にLINEミニアプリにアクセスできるようになります。ユーザー体験向上のため、「チャネル同意の簡略化」機能を有効にすることを推奨します。

なお、日本の新規LINEミニアプリチャネルでは「チャネル同意の簡略化」機能が常に有効になります。詳しくは、2026年1月8日のニュースを参照してください。

「チャネル同意の簡略化」機能が無効なLINEミニアプリでは「チャネル同意画面」が表示されます。

LINEミニアプリの設計によっては正しく動作しなくなる可能性があります

LIFF SDKで取得したアクセストークンIDトークンを使って、LINEログインAPIを実行する設計の場合、「チャネル同意の簡略化」機能によって、LINEミニアプリが期待どおりに動作しない可能性があります。

たとえば、IDトークンを検証するエンドポイントを実行し、取得したユーザーのプロフィール情報をLINEミニアプリのサービスアカウントの作成に利用する設計の場合、「チャネル同意の簡略化」機能によって、ユーザーのプロフィール情報(profileスコープ)の取得権限への同意がスキップされるため、IDトークンのペイロードにユーザーのプロフィール情報が含まれません。その結果、ユーザーのプロフィール情報をサービスアカウントの作成に利用できなくなります。

この問題を回避するには、アクセストークンやIDトークンを取得する前に、liff.permission.query()メソッドとliff.permission.requestAll()メソッドを使って「アクセス許可要求画面」を表示し、ユーザーに必要な権限を要求してください。詳しくは、「「アクセス許可要求画面」でopenidスコープ以外の権限を要求する」を参照してください。

「チャネル同意の簡略化」機能の設定方法

「チャネル同意の簡略化」機能は次の条件をすべて満たす場合のみ設定できます。

  • LINEミニアプリチャネルの[サービスを提供する地域]が「日本」である。
  • LINEミニアプリチャネルのステータスが「審査前」である。

2026年1月8日より前に作成されたLINEミニアプリチャネルの場合、「チャネル同意の簡略化」機能を有効化するには、LINE DevelopersコンソールのLINEミニアプリチャネルで、[ウェブアプリ設定]タブの「チャネル同意の簡略化」セクションのトグルをオン(右)にします。

なお、「チャネル同意の簡略化」機能はユーザーID(openidスコープ)の取得権限への同意を簡略化するため、有効化すると「Scope」セクションのopenidも自動的に有効になります。

2026年1月8日以降に作成されたLINEミニアプリチャネルの場合、「チャネル同意の簡略化」機能が常に有効になります。LINE Developersコンソール上の設定は不要です。

「チャネル同意の簡略化」機能の動作条件

「チャネル同意の簡略化」機能が動作するには、次の条件をすべて満たす必要があります。

  • LINEミニアプリが認証済ミニアプリである(※)。
  • LINEミニアプリのLIFF SDKのバージョンがv2.13.x以降である。
  • LINEミニアプリがLIFF間遷移で開かれていない。

※ 未認証ミニアプリでは、開発用と審査用のLINEミニアプリでのみ動作します。

「チャネル同意の簡略化」機能が有効なLINEミニアプリでの認可フロー

「チャネル同意の簡略化」機能が有効なLINEミニアプリでは、次の2段階でユーザーに権限を要求します。

  1. 「簡略化同意画面」でユーザーID(openidスコープ)の取得権限を要求する
  2. 「アクセス許可要求画面」でopenidスコープ以外の権限を要求する

1. 「簡略化同意画面」でユーザーID(openidスコープ)の取得権限を要求する

ユーザーが「チャネル同意の簡略化」機能が有効なLINEミニアプリに初めてアクセスすると、「簡略化同意画面」が表示されます。「簡略化同意画面」では、ユーザーにユーザーID(openidスコープ)の取得権限を許可するかどうかを確認します。

ユーザーが[同意する]をタップすると、読み込み画面が表示された後、LINEミニアプリを利用できるようになります。

また、[同意する]をタップしたことで、別のLINEミニアプリによるユーザーIDの取得にも同意したとみなされます。以降、「チャネル同意の簡略化」機能が有効なLINEミニアプリに初めてアクセスする際には、「チャネル同意画面」がスキップされ、すぐにLINEミニアプリを利用できるようになります。

ユーザーが[今はしない]をタップした場合の動作

ユーザーが[今はしない]をタップした場合、簡略化に対する同意がスキップされ、以降は 「チャネル同意の簡略化」が有効なLINEミニアプリを開いても「簡略化同意画面」が表示されなくなります。スキップ後、24時間が経過すると「簡略化同意画面」が再び表示されるようになります。

また、簡略化に対する同意をスキップしている間は、「「チャネル同意の簡略化」が無効なLINEミニアプリでの認可フロー」と同様に、LINEミニアプリごとの個別の「チャネル同意画面」が表示されます。

2. 「アクセス許可要求画面」でopenidスコープ以外の権限を要求する

liff.getProfile()メソッドやliff.sendMessages()メソッドなど、openidスコープ以外の権限を必要とするメソッドを実行すると、「アクセス許可要求画面」が表示されます。「アクセス許可要求画面」では、LINEミニアプリが要求する追加の権限を表示し、権限を許可するかどうかをユーザーに確認します。

openidスコープ以外の権限を必要とするメソッドは次のとおりです。

スコープメソッド
email
profile
chat_message.write

なお、liff.permission.query()メソッドとliff.permission.requestAll()メソッドを使うと、任意のタイミングで「アクセス許可要求画面」を表示できます。

javascript
liff.permission.query("profile").then((permissionStatus) => {
  if (permissionStatus.state === "prompt") {
    liff.permission.requestAll();
  }
});

詳しくは、『LIFF APIリファレンス』の「liff.permission.query()」と「liff.permission.requestAll()」を参照してください。

「アクセス許可要求画面」が表示されるタイミング

「アクセス許可要求画面」は、LINEミニアプリを開いたタイミングではなく、openidスコープ以外の権限(profileスコープやchat_message.writeスコープなど)を必要とするタイミングで初めて表示されます。

そのため、LINEミニアプリ起動直後に、liff.getProfile()メソッドなどopenidスコープ以外の権限を必要とするリクエストを実行する設計にしている場合は、LINEミニアプリにアクセスしたユーザーからは、アプリ起動時に「チャネル同意画面」がスキップせずに表示されたように見えてしまいます。openidスコープ以外の権限を必要とするリクエストは、可能な限り必要となるタイミングで初めて実行するように実装することをお勧めします。

「チャネル同意の簡略化」機能と友だち追加オプションを併用する際の注意点

LINEミニアプリでは、友だち追加オプションを使って、アクセス許可要求画面、もしくはチャネル同意画面からLINE公式アカウントの友だち追加への誘導ができます。

しかし、LINEミニアプリチャネルの[ウェブアプリ設定]タブの「Scope」セクションでopenidのみを指定している場合、「チャネル同意の簡略化」機能が有効になると、「アクセス許可要求画面」および「チャネル同意画面」が表示されなくなります。このため、友だち追加オプションによる友だち追加を誘導できなくなります。

「チャネル同意の簡略化」機能と友だち追加オプションを併用する際は、LINEミニアプリチャネルの[ウェブアプリ設定]タブの「Scope」セクションでopenid以外のスコープも指定した上で、アクセス許可要求画面を表示することを推奨します。詳しくは、「「アクセス許可要求画面」でopenidスコープ以外の権限を要求する」を参照してください。

「チャネル同意の簡略化」が無効なLINEミニアプリでの認可フロー

ユーザーが「チャネル同意の簡略化」が無効なLINEミニアプリに初めてアクセスすると、「チャネル同意画面」が表示されます。「チャネル同意画面」では、LINEミニアプリが要求する権限の一覧を表示し、権限を許可するかどうかをユーザーに確認します。

許可する]をタップすると、そのLINEミニアプリを利用できるようになります。

ユーザーの簡略化同意の有無による動作の違い

ユーザーが「簡略化同意画面」で簡略化に同意している場合、「チャネル同意の簡略化」機能が有効なLINEミニアプリに初めてアクセスする際は「チャネル同意画面」が表示されず、「読み込み画面」が表示された後すぐにLINEミニアプリを利用できます。

一方、ユーザーが「簡略化同意画面」で簡略化に同意していない場合、ユーザーがLINEミニアプリに初めてアクセスする際は、そのLINEミニアプリで「チャネル同意の簡略化」機能が有効かどうかに関係なく、「チャネル同意画面」が表示されます。

次の表では、ユーザーの簡略化同意の有無によって、あるLINEミニアプリに初めてアクセスした際の動作の違いを示しています。

LINEミニアプリユーザーが簡略化に同意しているユーザーが簡略化に同意していない
「チャネル同意の簡略化」が有効なLINEミニアプリ
「チャネル同意画面」がスキップされます。

「チャネル同意画面」が表示されます。
「チャネル同意の簡略化」が無効なLINEミニアプリ
「チャネル同意画面」が表示されます。

「チャネル同意画面」が表示されます。