active-directory-develop-guidedsetup-android-configure.md

Register your application

You can register your application in either of two ways, as described in the next two sections.

Option 1: Express mode

You can quickly register your application by doing the following:

1. Go to the Microsoft Application Registration Portal.

2. In the Application Name box, enter a name for your application.

3. Ensure that the Guided Setup check box is selected, and then select Create.

4. Follow the instructions for obtaining the application ID, and paste it into your code.

Option 2: Advanced mode

To register your application and add your application registration information to your solution, do the following:

1. If you haven't already registered your application, go to the Microsoft Application Registration Portal.

2. In the Application Name box, enter a name for your application.

3. Ensure that the Guided Setup check box is cleared, and then select Create.

4. Select Add Platform, select Native Application, and then select Save.

5. Under app > java > {host}.{namespace}, open MainActivity.

6. Replace [Enter the application Id here] in the following line with the application ID that you just registered:

   final static String CLIENT_ID = "[Enter the application Id here]";

7. Under app > manifests, open the AndroidManifest.xml file.

8. In the manifest\application node, add the following activity. Doing so registers a BrowserTabActivity activity that allows the OS to resume your application after it completes the authentication:

   <!--Intent filter to capture System Browser calling back to our app after sign-in-->
   <activity
       android:name="com.microsoft.identity.client.BrowserTabActivity">
       <intent-filter>
           <action android:name="android.intent.action.VIEW" />
           <category android:name="android.intent.category.DEFAULT" />
           <category android:name="android.intent.category.BROWSABLE" />
           
           <!--Add in your scheme/host from registered redirect URI-->
           <!--By default, the scheme should be similar to 'msal[appId]' -->
           <data android:scheme="msal[Enter the application Id here]"
               android:host="auth" />
       </intent-filter>
   </activity>

9. In the BrowserTabActivity node, replace [Enter the application Id here] with the application ID.