[C#]DropBox開發系列 - 使用DropNet進行DropBox的OAuth認證

筆者在DropBox開發系列 - App Key與App Secret的申請這篇介紹了DropBox開發前所要做的準備動作，這篇開始要進入實際撰寫程式的部分，介紹如何使用DropNet進行DropBox的OAuth認證。

要用DropNet進行DropBox程式的開發，首先我們必須要將DropNet必要的組件加入參考，這邊筆者是用NuGet直接將參考加入，不用NuGet的也可以直接去官網下載組件後加入參考。

DropNet組件加入後我們開始進行程式部份的撰寫，要用DropNet做DropBox的OAuth認證，大致來說可分為三個步驟： Get Request Token Authorize App with Dropbox Get an Access Token from the Request Token
  這三個步驟其實就是OAuth認證的步驟，有寫過OAuth認證的應該都不陌生，若是對OAuth不熟悉可參閱筆者[C#]OAuth認證開發這篇。

第一步取得Request Token的部份，我們直接叫用DropNetClient.GetToken()就可以了。 m_DropNetClient.GetToken();

第二步Authorize App with Dropbox則是先用DropNetClient.BuildAuthorizeUrl()取得使用者授權頁面的網址，然後開個瀏覽器把網頁導過去就可以了。

		using (var dialog = new Form())
		{
			var browesr = new WebBrowser()
			{
				Dock = DockStyle.Fill
			};
			var authUrl = m_DropNetClient.BuildAuthorizeUrl();
			browesr.Navigated += (s, ex) =>
			{
				var url = ex.Url.ToString();
				if (url.Equals(callbackUrl))
				{
					dialog.DialogResult = DialogResult.OK;
				}
				else if (url.Equals(cancelCallbackUrl))
				{
					dialog.DialogResult = DialogResult.Cancel;
				}
			};
			browesr.Navigate(authUrl);

			...
			dialog.Controls.Add(browesr);
			dialog.ShowDialog();
			...
		}

授權頁面跑起來會像是下面這樣，需要使用者先行用DropBox帳號做登入。

登入後會詢問使用者是否同意授權給該應用程式。

這邊若是選取Deny，頁面會被導到https://www.dropbox.com/home。

若是選取Allow，頁面會被導到指定的返回位置，也就是在叫用m_DropNetClient.BuildAuthorizeUrl()時帶入的位置。若是未指定返回位置，則頁面預設會被帶到https://www.dropbox.com/1/oauth/authorize。

所以在撰寫這步必須特別注意到要處理瀏覽器的Navigated事件，依照不同狀況做不同的處理。

第三步Get an Access Token from the Request Token跟第一步一樣簡單，在認證成功時叫用DropNetClient.GetAccessToken()就可以了。

整個認證部分的程式撰寫起來會像下面這樣：

	...
	var callbackUrl = "https://www.dropbox.com/1/oauth/authorize";
	var cancelCallbackUrl = "https://www.dropbox.com/home";
	var size = new Size(1024, 600);

	if (DoOAuth(callbackUrl, cancelCallbackUrl, size) == DialogResult.OK)
	{
		var accessToken = m_DropNetClient.GetAccessToken();
	}
	...

	private DialogResult DoOAuth(string callbackUrl, string cancelCallbackUrl, System.Drawing.Size size)
	{
		using (var dialog = new Form())
		{
			var browesr = new WebBrowser()
			{
				Dock = DockStyle.Fill
			};

			m_DropNetClient.GetToken();
			var authUrl = m_DropNetClient.BuildAuthorizeUrl();
			browesr.Navigated += (s, ex) =>
			{
				var url = ex.Url.ToString();
				if (url.Equals(callbackUrl))
				{
					dialog.DialogResult = DialogResult.OK;
				}
				else if (url.Equals(cancelCallbackUrl))
				{
					dialog.DialogResult = DialogResult.Cancel;
				}
			};
			browesr.Navigate(authUrl);

			dialog.Size = size;
			dialog.Controls.Add(browesr);

			return dialog.ShowDialog();
		}
	}

最後一樣完整的附上筆者在學習時所撰寫的使用範例：

using System; using System.Collections.Generic; using System.ComponentModel; using System.Data; using System.Drawing; using System.Linq; using System.Text; using System.Windows.Forms; using DropNet;

namespace DropNetDemo { public partial class Form1 : Form { #region Var private DropNetClient _dropNetClient; #endregion

	#region Private Property
	private DropNetClient m_DropNetClient
	{
		get
		{
			return _dropNetClient ?? (_dropNetClient = new DropNetClient(tbxAppKey.Text, tbxAppSecret.Text));
		}
		set
		{
			_dropNetClient = value;
		}
	}
	#endregion

	public Form1()
	{
		InitializeComponent();
	}

	private void btnLogin_Click(object sender, EventArgs e)
	{
		var callbackUrl = "https://www.dropbox.com/1/oauth/authorize";
		var cancelCallbackUrl = "https://www.dropbox.com/home";
		var size = new Size(1024, 600);

		if (DoOAuth(callbackUrl, cancelCallbackUrl, size) == DialogResult.OK)
		{
			var accessToken = m_DropNetClient.GetAccessToken();
		}
	}

	private DialogResult DoOAuth(string callbackUrl, string cancelCallbackUrl, System.Drawing.Size size)
	{
		using (var dialog = new Form())
		{
			var browesr = new WebBrowser()
			{
				Dock = DockStyle.Fill
			};

			m_DropNetClient.GetToken();
			var authUrl = m_DropNetClient.BuildAuthorizeUrl();
			browesr.Navigated += (s, ex) =>
			{
				var url = ex.Url.ToString();
				if (url.Equals(callbackUrl))
				{
					dialog.DialogResult = DialogResult.OK;
				}
				else if (url.Equals(cancelCallbackUrl))
				{
					dialog.DialogResult = DialogResult.Cancel;
				}
			};
			browesr.Navigate(authUrl);

			dialog.Size = size;
			dialog.Controls.Add(browesr);

			return dialog.ShowDialog();
		}
	}

	private void tbxAppKey_TextChanged(object sender, EventArgs e)
	{
		m_DropNetClient = null;
	}

	private void tbxAppSecret_TextChanged(object sender, EventArgs e)
	{
		m_DropNetClient = null;
	}
}

}