Browser sign in flow |
ブラウザでのログインフローは、ウェブサイトやブラウザを開いたり埋め込んだりできるアプリケーションに適しています。 At a very high level:
Twitter は承認状態を記録し続けるので、既にtwitter.com にログインしてアプリケーションを承認しているユーザーの場合は、UI は表示されません。 - 代わりに、それらユーザーは自動的にアプリケーションへ送り戻されます。
OverviewThe browser sign in flow is appropriate for websites and applications which are able to open or embed a web browser. At a very high level:
Twitter keeps track of the authorizations, so for users already signed in to twitter.com who have authorized the application, no UI is shown - instead, they are automatically redirected back to the application. |
To demonstrate the flows, pretend the website pictured to the right (“The greatest website ever created”) has implemented this API, as shown by the Sign in with Twitter button on the landing page.
ユーザーがログインボタンをクリックした時、ログインしているか、アプリケーションが自分のアカウントにアクセスするのを許可したか、によって表示されるページが変わります。
ユーザーがtwitter.comへログインしているがアクセスは許可していない場合、ログインに必要な権限の一覧とキャンセルボタンが表示されます。
ユーザーがtwitter.comにログインしていない場合、 ユーザー名とパスワードの入力欄が表示されます。ユーザーが既にアプリケーションへアクセス権を付与している場合でも、権限の一覧が表示されるので注意してください。
(必要であれば)ユーザーが有効な資格情報を入力して “Sign In”をクリックした後、 Twitter はユーザーをログインフローを開始したウェブサイトへリダイレクトします。
ユーザーが既にtwitter.com にログインしてウェブサイトにアクセス権を付与している場合は、即座にリダイレクトが発生します。
このログインフローを実装する方法について学ぶには、 Twitterへのログインを実装するを読んでください。
Desktop flowTo demonstrate the flows, pretend the website pictured to the right (“The greatest website ever created”) has implemented this API, as shown by the Sign in with Twitter button on the landing page. When the user clicks the Sign in button, the page they see depends on whether they are signed in and whether they have previously allowed the application to access their account. When the user is signed in to twitter.com but has not granted access, a list of requested permissions, along with Sign In and Cancel buttons are shown. When the user is not signed in to twitter.com input fields for a username and password will be shown. Note that even if the user has already granted access to the application, the list of permissions will still be shown. After the user inputs valid credentials (if needed) and clicks “Sign In”, Twitter will redirect the user to the website which started the sign in flow. In the case where the user is already signed in to twitter.com and has granted access to the website, this redirect happens immediately. To learn how to implement this sign in flow, read Implementing Sign in with Twitter |