E-NUM – это система авторизации, используемая для дополнительной защиты закрытых ресурсов онлайн-сервисов посредством секретного ключа (уникальной кодовой книги), хранимой в мобильном устройстве пользователя.

Вы можете легко интегрировать E-NUM авторизацию на Ваш ресурс.

Предлагается два способа интеграции: OAuth2 и Soap.

OAuth 2.0 позволяет предоставить третьей стороне доступ к защищенным ресурсам без необходимости сообщать ей (третьей стороне) данные аутентификации пользователя (число-вопрос, число-ответ).

E-NUM поддерживает спецификацию стандарта OAuth 2.0.

Схема авторизации на сайте банка с использованием системы E-NUM методом OAuth2.

Детальная схема авторизации с использованием системы E-NUM методом OAuth2 (сверху вниз)

1. Клиент банка запрашивает вход в защищенную зону онлайн-банкинга
2. Для предоставления доступа Банк требует пройти авторизацию, для чего перенаправляет его на сайт системы E-NUM
3. После успешной авторизации система E-NUM возвращает клиенту одноразовый код
4. Браузер клиента, в свою очередь, передает код авторизации сайту банка
5. Сайт банка, используя код авторизации, запрашивает у E-NUM временный токен доступа
6. Этот токен используется в дальнейшем для обращения к методам API E-NUM, которые обеспечивают идентификацию клиента.

• Запрос кода авторизации
• Получение кода авторизации
• Запрос токена доступа
• Получение токена доступа
• Получение идентификационных данных пользователя

Запрос кода авторизации

curl -i "https://auth.e-num.com/OAuth/Authorize?client_id=cd2068a8-cb18-4d24-bc85-dab0b3d3baf7&redirect_uri=https%3A%2F%2Fenumdemobank.e-num.com%2Fsignin-enum&scope=email%20phone&response_type=code&state=random-state"
HTTP/1.1 302 Found
Location: https://auth.e-num.com/Account/Login?ReturnUrl=%2FOAuth%2FAuthorize%3Fclient_id%3Dcd2068a8-cb18-4d24-bc85-dab0b3d3baf7%26redirect_uri%3Dhttps%253A%252F%252Fenumdemobank.e-num.com%252Fsignin-enum%26scope%3Demail%2520phone%26response_type%3Dcode%26state%3Drandom-state
                    

Получение кода авторизации

GET https://enumdemobank.e-num.com/signin-enum?code=db8cea2e8bea4328b1ed&state=random-state
                    

Запрос токена доступа

curl -i -d "client_id=cd2068a8-cb18-4d24-bc85-dab0b3d3baf7&client_secret=0e919552-1122-3344-5566-197f151bc349&redirect_uri=https%3A%2F%2Fenumdemobank.e-num.com%2Fsignin-enum&grant_type=authorization_code&code=db8cea2e8bea4328b1ed" "https://auth.e-num.com/OAuth/Token"
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
{
    "access_token":"2YotnFZFEjr1zCsicMWpAA",
    "token_type":"bearer",
    "expires_in":900,
    "refresh_token":"tGzv3JOkF0XG5Qx2TlKWIA"
}
                    

Получение токена доступа

Получение идентификационных данных пользователя

$ curl -i -H "Authorization: Bearer 2YotnFZFEjr1zCsicMWpAA" "https://auth.e-num.com/Api/Me"
HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8

{"email":"test@example.com","phone":"00000000000"}
                    

Метод интеграции Soap требует разового (первичного) перенаправления клиента на https://auth.e-num.com. Все последующие запросы не требуют перенаправления.

Схема авторизации с использованием системы E-NUM методом Soap.

• Пользователь стороннего сайта вводит свой email. Бекэнд сайта вызывает метод GetChallenge2 сервиса E-NUM (soap-интерфейс) для получения числа-вопроса.
• Сайт отображает число-вопрос и просит пользователя ввести число-ответ. Для проверки ответа пользователя используется метод CheckUserAnswer.
• При первой авторизации пользователь перенаправляется на сайт https://auth.e-num.com для получения разрешения пользователя на работу сайта с Е-NUM в связке с аккаунтом пользователя.

Для использования этой схемы владелец сайта должен зарегистрироватьcя на https://e-num.com/Account/Consumers.

Веб сервис http://service.e-num.com/Soap.asmx предоставляет базовые методы GetChallenge2 и CheckUserAnswer.

Метод GetChallenge2 (получение числа-вопроса)

Метод CheckUserAnswer (проверка ответа)

...
<form id="login" method="post">
    ...
    <input type="text" name="response" id="response" />
    ...
</form>
...
<script src="https://signalr2.enum.ru/js/jquery.min.js"></script>
<script src="https://signalr2.enum.ru/js/signalr.min.js"></script>
<script>
    $(function () {
        // сюда надо передавать параметр, полученный из метода GetChallenge2
        var sessionId = '<%= SessionId %>';
        var connection = new signalR.HubConnectionBuilder()
            .withUrl('https://signalr2.enum.ru/autoResponseHub?sessionId=' + sessionId, {
                skipNegotiation: true,
                transport: signalR.HttpTransportType.WebSockets
            })
            .build();
        connection.on('response', function (response) {
            if ($.trim(response) !== '') {
                $('input#response').focus();
                $('input#response').val(response);
                $('form#login').submit();
            }
        });
        connection.start();
    });
</script>

На примере несуществующего банка демонстрируем возможность авторизации с использованием E-NUM методом OAuth2.

Перейти на рабочий пример

Исходный код примера

Вы можете реализовать свой OAuth2-клиент E-NUM (согласно описанию методов API выше), или воспользоваться готовыми клиентскими библиотеками под вашу платформу.

Библиотека для Microsoft ASP.NET + Owin.

Пример на PHP.

Пример интеграции авторизации E-NUM Soap-методом.