Geekly Articles each Day

XamarinアプリケーションのOAuth認証

そのため、今日、Xamarinのアプリケーションでユーザーを承認するためのさまざまなメカニズムを引き続き扱います。 FacebookとVKontakte（ こことここ ）からSDKを理解した後、最も人気のある（現時点で）外部認証メカニズムの1つであるOAuthに移行できます。 Twitter、Microsoft Live、Githubなどの最も人気のあるサービスは、使い慣れた1つのアカウントを使用してサードパーティアプリケーションにログインする機能をユーザーに提供します。 OAuthの操作方法を学習することで、これらすべてのサービスを簡単に接続し、それらからユーザー情報を取得できます。

列のすべての記事は、リンク#xamarincolumnで 、またはカットの下の資料の最後で見つけて読むことができます。




OAuthの動作についてはすでにご存じのことを前提としていますが、そうでない場合は、 Habréに関するこの良い記事をお勧めします 。 つまり、OAuthを承認すると、ユーザーは最終的なURLに移動するまで、あるWebページから別のWebページにリダイレクトされます（通常2〜3ステップ）。 この最終的な遷移は、WebViewレベルでアプリケーション（自分でロジックを記述した場合）で捕捉され、必要なデータ（トークンとその有効期間）がURLで直接指定されます。


OAuthユーザー認証を提供する人気のあるサービスの小さなリスト：Odnoklassniki、Mail.ru、Dropbox、Foursquare、GitHub、Instagram、LinkedIn、Microsoft、Slack、SoundCloud、Visual Studio Online、Trello。


Xamarin.Auth


XamarinでOAuthを使用するために、1年以上開発されており、必要なすべてのメカニズムを備えたシンプルで便利なXamarin.Authライブラリに注目します。


  1. 認証ページを使用したブラウザーの表示
  2. フロー管理と承認プロセスのリダイレクト
  3. 適切なデータを取得する
  4. ユーザー情報を取得するなど、追加のサービスリクエストのメカニズムを提供する

Xamarin.Authは、ユーザー資格情報を安全なストレージに保存する機能もサポートしています。 一般に、必要な機能を備えた成熟した高品質のコンポーネント。


Xamarinコンポーネントのバージョンは古く、更新されていないため、NugetからXamarin.Authをインストールすることをお勧めします。




FacebookとVKontakteのSDKを使用した認証について以前に説明したことを思い出してください。 この例では、すべての承認ロジックをプラットフォームプロジェクトに組み込み、PCLにはインターフェイスのみを残しました。 OAuthについては、Xamarin.Auth自体でのPCLサポートにもかかわらず、同じ方法で進みます。


Xamarin.Authに加えて、ブルーノベルナルドのXamarin.Forms.OAuthライブラリもお勧めします。 古典的なXamarinを使用している場合でも、このプロジェクトのソースコードでは、さまざまなサービスの多くの既成の構成を見つけることができます。


OAuthの仕組みの例として、Microsoftを使用した承認を有効にします。 まず、Webサイトhttps://apps.dev.microsoft.comでアプリケーションを作成し、そこにクライアントID（クライアントまたはアプリケーションID）を取得します。



PCLで認証を接続します


PCLレベルでは、すべてが通常通りです。プラットフォームサービス用の単純なIOAuthServiceインターフェイスを作成し、プロジェクトに新しい依存関係を追加しません。


public interface IOAuthService {    Task<LoginResult> Login();    void Logout(); }

もちろん、承認ページ内でDependencyService.Get<IOAuthService>().Login()およびDependencyService.Get<IOAuthService>().Logout()への呼び出しを追加する必要があります。


複数のOAuthサービスのサポートを追加しても問題はありません。 これを行うには、 providerName引数（ string 、 intまたはenum型）をLogin()およびLogout()メソッドに追加し、その値に応じてサービスプロバイダーを選択します。


プラットフォームの実装


前述したように、Xamarin.AuthライブラリをNugetから各プラットフォームプロジェクト（この場合はiOSとAndroid）に追加する必要があります。 次に、各プラットフォームのIOAuthService実装を記述し、 Dependencyとして登録します。


次に、必要なパラメーターを使用してOAuth2Authenticatorクラスのインスタンスを作成するだけです。


  var auth = new OAuth2Authenticator          (              clientId: "_CLIENT_ID",              scope: "wl.basic, wl.emails, wl.photos",              authorizeUrl: new Uri("https://login.live.com/oauth20_authorize.srf"),              redirectUrl: new Uri("https://login.live.com/oauth20_desktop.srf"),              clientSecret: null,              accessTokenUrl: new Uri("https://login.live.com/oauth20_token.srf")          )          {              AllowCancel = true          };

それでは、認証完了ハンドラーを切断しましょう。


 auth.Completed += AuthOnCompleted;

すべて、 auth.GetUI()メソッドを通じて取得した、承認用の組み込みWebブラウザーを使用してモーダルウィンドウを表示できます。 iOSでは、次のようなことができます。


 UIApplication.SharedApplication.KeyWindow.RootViewController.PresentViewController(auth.GetUI(), true, null);

Androidでは、Xamarin.Formsを使用する場合、コードは次のようになります。


 Forms.Context.StartActivity(auth.GetUI(Forms.Context));

認証に成功すると、 AuthOnCompleted()メソッドがAuthOnCompleted()れます。iOSの場合は、ブラウザーでモーダルウィンドウを非表示にする必要があります（Androidで非表示になります）。


 UIApplication.SharedApplication.KeyWindow.RootViewController.DismissViewController(true, null);

これで、必要なデータを取得できます（ expires_inとその有効期間（秒expires_in ） expires_in ）


 var token = authCompletedArgs.Account.Properties["access_token"];              var expireIn = Convert.ToInt32(authCompletedArgs.Account.Properties["expires_in"]); var expireAt = DateTimeOffset.Now.AddSeconds(expireIn);

そして最後のステップは私たちのために残っていました-メールやアバターへのリンクなど、ユーザープロファイルから高度な情報を取得します。 このため、Xamarin.Authには特別なクラスOAuth2Requestがあり、これを使用してこのような要求を行うのに便利です。


  var request = new OAuth2Request("GET", new Uri("https://apis.live.net/v5.0/me"), null, account); var response = await request.GetResponseAsync();

これで、ユーザーデータを含むJSONを受け取り、アプリケーションに保存して表示できます。


  if (response.StatusCode == HttpStatusCode.OK) {   var userJson = response.GetResponseText();   var jobject = JObject.Parse(userJson);   result.LoginState = LoginState.Success;   result.Email = jobject["emails"]?["preferred"].ToString();   result.FirstName = jobject["first_name"]?.ToString();   result.LastName = jobject["last_name"]?.ToString();   result.ImageUrl = jobject["picture"]?["data"]?["url"]?.ToString();   var userId = jobject["id"]?.ToString();   result.UserId = userId;   result.ImageUrl = $"https://apis.live.net/v5.0/{userId}/picture"; }

ご覧のとおり、複雑なことは何もありません。 問題は、承認プロセスのURLを正しく登録することです。 まあ、 expires_inフィールドには秒単位の時間が含まれていることを思い出してexpires_in （これはよくある質問をexpires_inます）。




実際のプロジェクトでは、エラーハンドラーをauth.Errorイベントに割り当てることをお勧めします。 auth.Errorば、問題が解決策なしに残されることはありません。


おわりに


本日、ユーザーを認証し、外部サービスを通じてユーザーに関する基本的な情報を取得するための一般的なすべての方法のレビューを完了しました。 説明したメカニズムは、Xamarin.Formsと従来のXamarin iOS / Androidの両方に適しています。 すべての例を含むプロジェクトの完全なソースコードは、リポジトリにあります。


https://bitbucket.org/binwell/login


記事へのコメントで質問して、連絡を取り合いましょう！



著者について


Vyacheslav Chernikovは 、 Binwell 、Microsoft MVP、およびXamarin認定開発者の開発責任者です。 過去には、Nokia ChampionおよびQt認定スペシャリストの1人で、現在はXamarinおよびAzureプラットフォームのスペシャリストです。 彼は2005年にモバイル分野に参入し、2008年からモバイルアプリケーションを開発しています。Symbian、Maemo、Meego、Windows Mobileから始め、その後iOS、Android、Windows Phoneに切り替えました。 Mediumブログで Vyacheslavの記事を読むこともできます。

著者の他の記事：

Source: https://habr.com/ru/post/J332970/

More articles:


All Articles