B2BB2CH2H

Инструкция по подключению

Песочница API - это среда, которую Партнеры API могут использовать для имитации производственной среды и получения смоделированных ответов по всем API.

Песочница позволяет пройти аутентификацию в Alfa ID и вызвать методы Alfa API в тестовом режиме, не воздействуя на реальные данные.

Для использования песочницы необходимо
1

Заключить договор о техническо-информационном взаимодействии

2

Получить тестовый client_id и scope

Сотрудники Банка предоставят тестовый client_id и доступный scope

3

Установить тестовый TLS-сертификат

Для получения доступа необходимо установить тестовый TLS-сертификат - test_cert.zip - пароль для архива уточняйте у персонального менеджера.

Архив состоит из файлов:

  • •
    test_certificate.cer - сертификат для клиента (открытый ключ);
  • •
    test_key.key - закрытый ключ;
  • •
    apica_2022_chain.cer - цепочка сертификатов УЦ (содержит в себе root_apica_2022.cer и sub_root_apica_2022.cer);
  • •
    root_apica_2022.cer - корневой сертификат УЦ;
  • •
    sub_root_apica_2022.cer - промежуточный сертификат УЦ;
  • •
    test_pkcs.p12 - контейнер p12, содержащий вышеперечисленные файлы.

Для доступа к Swagger UI можно использовать следующие комбинации (в зависимости от выбора вашего ПО для работы с API):

  • •
    Открытый ключ + закрытый ключ + цепочка сертификатов УЦ;
  • •
    Открытый ключ + закрытый ключ + корневой сертификат УЦ + промежуточный сертификат УЦ;
  • •
    Контейнер p12 (test_pkcs.p12) - самый простой способ.

Для вызова методов можно использовать стандартные программные средства для работы с API: Postman, SoapUI, JMeter, curl или использовать самописные программные средства или встроенные возможности ERP-системы.

4

Проверить тестовый Swagger UI

5

Получить client_secret

При использовании песочницы все вызовы API должны осуществляться с использованием закрытого ключа и сертификата.

Пример запроса
curl -X GET https://sandbox.alfabank.ru/api/v1/endpoint \
  -v--cert test_certificate.cer \
  --key test_key.key \
  --header 'accept: application/json' \
  --header 'content-type: application/json' \
Адреса для тестирования

Получение кода авторизации - https://id-sandbox.alfabank.ru/oidc/authorize?response_type=code&client_id={client_id}&redirect_uri={redirect_uri}&scope={scope}&state={state}

Другие запросы в Alfa ID - https://sandbox.alfabank.ru/oidc

Запросы в Alfa API - https://sandbox.alfabank.ru/api

Рекомендации по тестированию Alfa ID ЮЛ

Для прохождения процедуры аутентификации используйте тестовые логин и пароль, OTP.

  • •
    Login: SomeDifficultLogin
  • •
    Password: 1qaz!QAZ
  • •
    One-Time Password: 000000

Для подписания формы согласия используйте:

  • •
    One-Time Password: 111111

Подробнее в разделе Alfa ID.

Рекомендации по тестированию Alfa ID ФЛ

Для прохождения процедуры аутентификации используйте тестовые логин и пароль, ОТР.

  • •
    Номер телефона: 71111111111
  • •
    Login: SomeDifficultLogin
  • •
    Password: 000000
  • •
    One-Time Password: 000000

Для подписания формы согласия используйте:

  • •
    One-Time Password: 000000

Подробнее в разделе Alfa ID.

ЭкранированиеИнструкция по тестированию