Name: Lock-Facebook.Android
Owner: Auth0
Description: Lock for Android add-on to use Facebook Android SDK
Created: 2015-05-27 14:17:15.0
Updated: 2018-02-08 07:13:21.0
Pushed: 2017-08-09 13:52:07.0
Homepage: https://auth0.com/lock
Size: 196
Language: Java
GitHub Committers
| User | Most Recent Commit | # Commits |
|---|
Other Committers
| User | Most Recent Commit | # Commits |
|---|
Auth0 is an authentication broker that supports social identity providers as well as enterprise identity providers such as Active Directory, LDAP, Google Apps and Salesforce.
Lock-Facebook helps you integrate native Login with Facebook Android SDK and Lock
This package relies on a token endpoint that is now considered deprecated. If your Auth0 client was created after Jun 8th 2017 you won't be able to use this package. This repository is left for reference purposes.
We recommend using browser-based flows to authenticate users. You can do that using the auth0.android package's WebAuthProvider class, as explained in this document.
Android 4.0 or later & Facebook Android SDK 4.+
The Lock-Facebook is available through Maven Central and JCenter. To install it, simply add the following line to your build.gradle:
ile 'com.auth0.android:lock-facebook:3.1.0'
APP ID and APP SECRET values.APP ID value obtained in the step 2 of the Facebook Developers Console section above.APP SECRET value obtained in the step 2 of the Facebook Developers Console section above. Click the Save button.res/strings.xml file. Name it facebook_app_id and set as value the APP ID obtained in the step 2 of the Facebook Developers Console setup section above.FacebookActivity and facebook_app_id MetaData to the AndroidManifest.xml file, inside the Application tag.ivity
android:name="com.facebook.FacebookActivity"
android:configChanges="keyboard|keyboardHidden|screenLayout|screenSize|orientation"
android:label="@string/app_name"/>
a-data
android:name="com.facebook.sdk.ApplicationId"
android:value="@string/facebook_app_id" />
AndroidManifest.xml file.s-permission android:name="android.permission.INTERNET" />
FacebookAuthProvider.ic class MainActivity extends AppCompatActivity {
ivate FacebookAuthProvider provider;
...
verride
otected void onCreate(Bundle savedInstanceState) {
Auth0 auth0 = new Auth0(getString(R.string.com_auth0_client_id), getString(R.string.com_auth0_domain));
final AuthenticationAPIClient client = new AuthenticationAPIClient(auth0);
provider = new FacebookAuthProvider(client);
...
Depending on your use case, you'll need to add a few more lines of code to capture the authorization result. Follow the guides below:
If you need further help with the setup, please check Facebook's Getting Started Guide.
This library includes an implementation of the AuthHandler interface for you to use it directly with Lock. Create a new instance of the FacebookAuthHandler class passing a valid FacebookAuthProvider. Don't forget to customize the permissions if you need to.
0 auth0 = new Auth0("auth0-client-id", "auth0-domain");
bookAuthProvider provider = new FacebookAuthProvider(new AuthenticationAPIClient(auth0));
ider.setPermissions(Arrays.asList("public_profile", "user_photos"));
bookAuthHandler handler = new FacebookAuthHandler(provider);
Finally in the Lock Builder, call withAuthHandlers passing the recently created instance.
= Lock.newBuilder(auth0, authCallback)
.withAuthHandlers(handler)
//...
.build(this);
That's it! When Lock needs to authenticate using that connection name, it will ask the FacebookAuthHandler for a valid AuthProvider.
We provide this demo in the
PhotosActivityclass. We also use the Facebook SDK to get the User Albums and show them on a list.
Just create a new instance of FacebookAuthProvider with an AuthenticationAPIClient.
0 auth0 = new Auth0("auth0-client-id", "auth0-domain");
l AuthenticationAPIClient client = new AuthenticationAPIClient(auth0);
bookAuthProvider provider = new FacebookAuthProvider(client);
Override your activity's onActivityResult method and redirect the received parameters to the provider instance's authorize method.
rride
ected void onActivityResult(int requestCode, int resultCode, Intent data) {
if (provider.authorize(requestCode, resultCode, data)) {
return;
}
super.onActivityResult(requestCode, resultCode, data);
Call start to begin the authentication flow.
ider.start(this, callback, RC_PERMISSIONS, RC_AUTHENTICATION);
That's it! You'll receive the result in the AuthCallback you passed.
We provide this demo in the
SimpleActivityclass.
To use a custom social connection name to authorize against Auth0, call setConnection with your new connection name.
bookAuthProvider provider = new FacebookAuthProvider("my_connection_name", client);
By default, the permission public_profile is requested. You can customize them by calling setPermissions with the list of Permissions.
ider.setPermissions(Arrays.asList("public_profile", "user_photos"));
This provider doesn't require any special Android Manifest Permission to authenticate the user. But if your use case requires them, you can let the AuthProvider handle them for you. Use the setRequiredPermissions method.
ider.setRequiredPermissions(new String[]{"android.permission.GET_ACCOUNTS"});
To log out the user so that the next time he's prompted to input his credentials call clearSession. After you do this the provider state will be invalid and you will need to call start again before trying to authorize a result. Calling stop has the same effect.
ider.clearSession();
By default, this provider will remember the last account used to log in. If you want to change this behavior, use the following method.
ider.rememberLastLogin(false);
If you have found a bug or if you have a feature request, please report them at this repository issues section. Please do not report security vulnerabilities on the public GitHub issue tracker. The Responsible Disclosure Program details the procedure for disclosing security issues.
Auth0 helps you to:
Lock-Facebook is available under the MIT license. See the LICENSE file for more info.