summaryrefslogtreecommitdiffstats
path: root/samples/DotNetOpenAuth.ApplicationBlock/OAuth2/Facebook/FacebookClient.cs
blob: b8717f7e8c0aee381d77558585aa065c658947e9 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
//-----------------------------------------------------------------------
// <copyright file="FacebookClient.cs" company="Outercurve Foundation">
//     Copyright (c) Outercurve Foundation. All rights reserved.
// </copyright>
//-----------------------------------------------------------------------

namespace DotNetOpenAuth.ApplicationBlock {
	using System;
	using System.Collections.Generic;
	using System.IO;
	using System.Linq;
	using System.Net;
	using System.Text;
	using System.Web;
	using DotNetOpenAuth.Messaging;
	using DotNetOpenAuth.OAuth2;

	public class FacebookClient : WebServerClient {
		private static readonly AuthorizationServerDescription FacebookDescription = new AuthorizationServerDescription {
			TokenEndpoint = new Uri("https://graph.facebook.com/oauth/access_token"),
			AuthorizationEndpoint = new Uri("https://graph.facebook.com/oauth/authorize"),
			ProtocolVersion = ProtocolVersion.V20
		};

		/// <summary>
		/// Initializes a new instance of the <see cref="FacebookClient"/> class.
		/// </summary>
		public FacebookClient()
			: base(FacebookDescription) {
		}

		public IOAuth2Graph GetGraph(IAuthorizationState authState, string[] fields = null) {
			if ((authState != null) && (authState.AccessToken != null)) {
				string fieldsStr = (fields == null) || (fields.Length == 0) ? FacebookGraph.Fields.Defaults : string.Join(",", fields);

				WebRequest request = WebRequest.Create("https://graph.Facebook.com/me?access_token=" + Uri.EscapeDataString(authState.AccessToken) + "&fields=" + fieldsStr);
				WebResponse response = request.GetResponse();

				if (response != null) {
					Stream responseStream = response.GetResponseStream();

					if (responseStream != null) {
						return FacebookGraph.Deserialize(responseStream);
					}
				}
			}

			return null;
		}

		/// <summary>
		/// Well-known permissions defined by Facebook.
		/// </summary>
		/// <remarks>
		/// This sample includes just a few permissions.  For a complete list of permissions please refer to:
		/// https://developers.facebook.com/docs/reference/login/
		/// </remarks>
		public static class Scopes {
			#region Email Permissions
			/// <summary>
			/// Provides access to the user's primary email address in the email property. Do not spam users. Your use of email must comply both with Facebook policies and with the CAN-SPAM Act.
			/// </summary>
			public const string Email = "email";
			#endregion

			#region Extended Permissions
			/// <summary>
			/// Provides access to any friend lists the user created. All user's friends are provided as part of basic data, this extended permission grants access to the lists of friends a user has created, and should only be requested if your application utilizes lists of friends.
			/// </summary>
			public const string ReadFriendlists = "read_friendlists";

			/// <summary>
			/// Provides read access to the Insights data for pages, applications, and domains the user owns.
			/// </summary>
			public const string ReadInsights = "read_insights";
			#endregion

			#region Extended Profile Properties
			/// <summary>
			/// Provides access to the "About Me" section of the profile in the about property
			/// </summary>
			public const string UserAboutMe = "user_about_me";

			/// <summary>
			/// Provides access to the user's list of activities as the activities connection
			/// </summary>
			public const string UserActivities = "user_activities";

			/// <summary>
			/// Provides access to the birthday with year as the birthday property. Note that your app may determine if a user is "old enough" to use an app by obtaining the age_range public profile property
			/// </summary>
			public const string UserBirthday = "user_birthday";
			#endregion

			#region Open Graph Permissions
			#endregion

			#region Page Permissions
			#endregion

			#region Public Profile and Friend List
			#endregion
		}
	}
}