7.4 Helping Users Register Their Mobile Devices

Users can install the MobileAccess app on a mobile device to use MobileAccess with Access Manager Appliance. A user can register a device with multiple providers by setting up separate accounts for each one. If a user registers a device with multiple providers, the user must select the account to use for a session from the providers listed on the device. By default, the app connects the user to the first provider in the list.

As an administrator, you can provide two different ways for users to register a mobile device with Access Manager Appliance.

7.4.1 Registering iOS Devices

There are two different ways you can provide to users to register an iOS mobile device.

Manual: Send your users an email with the URL to the IDP server including the correct port number. The users enter the IDP URL in the MobileAccess app by tapping the menu in the upper left corner of the MobileAccess app, then tap Accounts > + to enter the URL of the IDP in the Providers field. The URL is:
```
https://IDP_server_dns_name:port
```
For example:
```
https://idp.acme.com:8443
```
Embedded Link in Email: You can send your users the following link. When the users click the link, the link launches the MobileAccess app and the user is presented with the Sign In page. The user signs in using their corporate credentials to access the appmarks available in the MobileAccess app. The link is:
```
comnetiqauth://x-callback-url/register?providerUrl=https://
IDP_server_dns_name:port/
```
For example:
```
comnetiqauth://x-callback-url/register?providerUrl=https://idp.acme.com:8443/
```
NOTE:Email client can prevent embedded links from working.

7.4.2 Registering Android Devices

There are two different ways you can provider to users to register an Android device.

Manual: Send your users an email with the URL to the IDP server including the correct port number. The users enter the IDP URL in the MobileAccess app by tapping the menu in the upper right corner of the MobileAccess app, then tapping Manage Accounts > + to enter the URL of the IDP in the Provider field. The URL is:
```
https://IDP_server_dns_name:port
```
For example:
```
https://idp.acme.com:8443
```

HTML Page with Anchor Link: You can also create an HTML page that contains an anchor link that users click on to have the Provider field populated for them. The format of the anchor link is:

<html>
  <body><a href="intent://x-callback-url/register?providerUrl= https://IDP_server_dns_name:port#Intent;scheme=comnetiqauth;package=com.netiq.mobileaccessforandroid;end;">Register</a></body>
</html>

For example:

<html>
  <body><a href="intent://x-callback-url/register?providerUrl= https://idp.acme.com:8443#Intent;scheme=comnetiqauth;package=com.netiq.mobileaccessforandroid;end;">Register</a></body>
</html>