#IDP2-NativeApp-Android

Проект включает три модуля:

• SDK — интегрированный SDK;
• DEMO — интегрированный пример;
• DOC — интегрированная документация.

###IDPNativeAppSDK — Android — разработка документации Дата обновления: 5 декабря 2016 года Версия SDK: 1.0.0

###1. Введение

Продукт IDP от компании «Девять провинций Юньтэн» имеет слоган «Единая идентификация, безопасность и удобство». Однофакторный вход в систему (Single Sign On, SSO) для Android SDK позволяет управлять идентификацией и осуществлять однофакторный вход на стороне третьих разработчиков приложений.

Если вы не знакомы с IDP, вы можете связаться с нами по адресу info@idsmanager.com или посетить наш веб-сайт http://www.idsmanager.com для получения дополнительной информации. Продукт IDP предназначен для корпоративных пользователей, а SSO SDK предназначен для внутренних разработчиков предприятий. Система IDP может безопасно и удобно управлять учётными записями сотрудников внутри корпоративных приложений.

####Реализованные функции:

Переход от IDP Identity Guardian к стороннему приложению с использованием имени пользователя и пароля (U+P), а также получение информации об учётной записи из приложения IDP Identity Guardian для бесшовного подключения к системе однофакторного входа и непосредственного входа в систему.

####Функции, которые будут реализованы:

Помимо U+P, будет предложена более безопасная и эффективная аутентификация на основе токенов OAuth или OIDC.

####Поддержка версий системы:

В настоящее время SDK поддерживает версии телефонов Android 4.0.3 и выше.

При возникновении вопросов обращайтесь по адресу info@idsmanager.com или звоните по телефону 010-58732285.

###2. Как установить

libs: idp2nativeapp1.0.jar

###3. Использование IDPNativeAppSDK

Использование idp2nativeapp1.0.jar включает следующие шаги.

####1. Включите пакет для вашего приложения compile files('libs/idp2nativeapp1.0.jar')

compile 'com.squareup.okhttp3:okhttp:3.3.1'

compile 'com.squareup.okio:okio:1.8.0'

compile 'com.google.code.gson:gson:2.3.1'

####2. Добавьте следующее в ваш файл AndroidManifest.xml Запрос разрешения на доступ в Интернет

<uses-permission android:name="android.permission.INTERNET" />

Настройка режима запуска Acitivity как одиночной задачи

android:launchMode="singleTask"

Добавьте фильтр намерений в Activity, который будет использоваться для взаимодействия с IDP Identity Guardian и передачи данных. Значение android:scheme должно соответствовать URL-адресу схемы Android, согласованному с сервером.

<intent-filter>
   <action android:name="android.intent.action.VIEW" />
   <category android:name="android.intent.category.DEFAULT" />
   <category android:name="android.intent.category.BROWSABLE" />
   <!--Пожалуйста, сохраните соответствие с конфигурацией сервера
       scheme представляет собой строку, состоящую из букв длиной не более 12 символов-->
   <data
       android:host="NativeApp"
       android:scheme="настраиваемая" />
</intent-filter>

UserReceiver — это широковещательный приёмник, созданный в проекте, который необходимо написать самостоятельно и который используется для приёма информации о пользователе. См. UserReceiver в демо.

<receiver android:name=".receive.UserReceiver">

        <intent-filter>

            <action android:name="com.idsmanager.nativeappdemo.summer.userinfo" />

        </intent-фильтр>

    </receiver>

####3. Инициализируйте SDK в Application

IDP2NativeApp.init(getApplicationContext());

####4. Получите данные в стартовом Activity

1. В методе onCreate (приложение без каких-либо фоновых процессов получает данные).

getData(getIntent());

2. В методе onNewIntent (приложение открыто в фоновом режиме получает данные).

@Override
protected void onNewIntent(Intent intent) {
   super.onNewIntent(intent);
   setIntent(intent);
   getData(intent);
}

3. Метод получения данных обрабатывает данные.

 private void getData(Intent intent) {
        if (intent !=null) {
            Uri uri = intent.getData();
            if (uri != null) {
                String applicationUuid = uri.getQueryParameter("applicationUuid");
                String nativeToken = uri.getQueryParameter("nativeToken");
                String head = uri.getQueryParameter("head");
                if(!TextUtils.isEmpty(applicationUuid)||!TextUtils.isEmpty(nativeToken)||!TextUtils.isEmpty(head)){
                    //Получаем данные и получаем информацию об учетной записи
                    IDP2NativeApp.getInfo(head, applicationUuid, nativeToken);
                }
            }
        }
    }

Примечание: При импорте соответствующего jar-файла в Eclipse, за исключением первого шага, остальные шаги остаются неизменными. ###4. Настройка однофакторного входа IDP

Название продукта на рынке IDP — IDP Identity Guardian, он поддерживает iOS и Android и доступен для загрузки в App Store и магазине приложений. Этот продукт является важной частью линейки продуктов IDP и в сочетании с веб-интерфейсом обеспечивает безопасный и удобный способ управления и использования личных учётных данных. IDP Identity Guardian предоставляет поддержку управления идентификацией для локальных приложений, что является важным модулем для реализации единого управления всеми сетевыми идентификаторами на мобильных устройствах. Предоставленный нами SDK направлен на то, чтобы предоставить разработчикам предприятий способ подключения к IDP и реализовать управление учётными данными и однофакторный вход между приложениями IDP и сторонними приложениями.

Чтобы реализовать единое управление учётными данными IDP и однофакторный вход, ваша компания должна использовать продукт IDP, и у вас должны быть права администратора. Права разработчика не позволяют добавлять приложения Native App, пожалуйста, обратите внимание.

####1 . В интерфейсе администратора IDP нажмите «Добавить приложение», выполните поиск «Native App» и увидите предоставленный нами шаблон. Мы используем этот шаблон и нажимаем «Добавить приложение». (Если шаблон не найден, обратитесь в Девять провинций Юньтэн.)

####2 . Продолжайте заполнять необходимую информацию о приложении.

Область применения: выберите наиболее подходящий вариант в соответствии с ситуацией, выбор здесь не повлияет на реализацию приложения. URL-адрес схемы iOS/Android: при заполнении значения android:scheme в AndroidManifest рекомендуется ссылаться на значение android:scheme. Способ привязки учётных данных: здесь выберите способ, которым вы хотите передать информацию об учётных данных пользователя из IDP Identity Guardian в ваше приложение. В настоящее время поддерживается только способ имени пользователя и пароля, в будущем будет предоставлен токен на основе OIDC или OAuth.

####3 . Авторизуйте приложение, чтобы пользователи могли начать его использовать. Если вы знаете, как авторизовать приложение, пропустите этот раздел. Авторизация: Авторизация означает процесс предоставления доступа к приложению, добавленному корпоративным пользователем. После добавления приложения в систему IDP необходимо авторизовать его для пользователей. Если приложение находится в состоянии готовности (по умолчанию), пользователи в соответствующей группе смогут увидеть новое добавленное приложение в своём IDP Guardian. Войдите в меню авторизации слева. Выберите недавно созданное приложение из списка. Добавьте новую авторизацию. На новой странице выберите группу пользователей, которую вы хотите авторизовать, например, тестовую группу, группу управления и т. д. Если группа пользователей не создана, вы можете создать её самостоятельно. Если пользователь не добавлен, пожалуйста, добавьте пользователя и поместите его в группу пользователей.

####4. Применение завершено после выполнения этого шага, но нам всё ещё нужно добавить информацию об учётной записи пользователя в этом приложении для авторизованных пользователей в группе пользователей, чтобы можно было передать эту информацию в стороннее приложение при переходе. Если вы знаете, как авторизовать добавление учётных записей дочерних приложений, выполните авторизацию самостоятельно и пропустите этот раздел.

#####a. Выйдите из системы и войдите снова, используя учётную запись пользователя из группы пользователей, которую вы только что авторизовали. Если администратор, который только что вошёл в систему, является членом группы авторизованных членов, вам не нужно выходить из системы, просто перейдите в интерфейс пользователя, выбрав его в раскрывающемся меню панели навигации в правом верхнем углу.

#####b. Войдите в меню учётных записей дочерних приложений и увидите список информации об учётных записях всех авторизованных приложений. Нажмите кнопку «Добавить учётную запись дочернего приложения» в правом верхнем углу.

#####c. В интерфейсе добавления выберите правильное приложение и введите имя пользователя и пароль, соответствующие действительной учётной записи в вашем стороннем приложении. Например, если я разработал приложение под названием «WeChat Mod», я хочу, чтобы IDP Identity Manager помог мне управлять им и реализовать единый вход. Этот аккаунт должен быть зарегистрирован в вашей собственной системе и может использоваться.

Если вы пытаетесь использовать демонстрационное приложение IDPNativeApp, зарегистрируйтесь после запуска IDPNativeApp и введите регистрационную информацию на этом этапе. Вы можете добавить несколько учётных записей, которые необходимо управлять для одного и того же приложения. IDP Identity Manager спросит вас, какую учётную запись вы хотите использовать перед переходом.

Мы добавили IDPNativeAppSDK шаг за шагом, настроили URL Scheme, создали соответствующее URL Scheme приложение на веб-сайте IDP и добавили информацию об учётной записи целевого приложения для этого пользователя после авторизации целевой группы.

Теперь ваше приложение должно иметь возможность использовать IDP Identity Manager для управления и входа в ваше приложение!

Пожалуйста, свяжитесь с нами по адресу info@idsmanager.com, если у вас есть ценные предложения. Мы будем предоставлять более полные функции SDK для пользователей и разработчиков IDP в будущем. Пожалуйста, ожидайте с нетерпением!

Команда Девятой Облачной Группы Пекина

Декабрь 2016 года