Skip to content

Интерфейс единого входа - FineReport Справочная документация|Разработка отчетов|Использование отчетов|Учебные пособия

Фронтальный интерфейс единого входа

1. Обзор

В этой статье описываются интерфейсы единой регистрации, поддерживаемые продуктом.

Примечание: Мы предоставляем официальные интерфейсы, связанные с FanSoft Singularity, и решаем только проблемы, связанные с вызовом официального интерфейса. Если в процессе эксплуатации у пользователя возникают какие-либо ошибки, не связанные с интерфейсом, пожалуйста, обратитесь к техническому персоналу компании пользователя для изучения и решения проблемы.

2. Единая регистрация на фронтальной стороне

Вам нужно поместить имя пользователя и пароль за url для аутентификации входа, с помощью iframe или ajax можно добиться кросс-доменного поведения единого входа во фронтенде. Нужно только добавить вызов интерфейса на страницу входа пользователя, не нужно адаптировать в фоновом режиме. Системная учетная запись и пароль пользователя должны быть такими же, как и в платформе Fansoft.

2.1 Введение в интерфейсы

Существует два способа реализации фронтального единого входа в систему FineBI: способ iframe и способ Ajax.

Независимо от способа входа в систему, система FineBI предоставляет пользователям единый интерфейс, который показан ниже:

Примечание: Этот интерфейс представляет собой запрос на получение.

  
http://localhost:8080/webroot/decision/login/cross/domain?fine_username=XX&fine_password=XX&validity= -2&callback=

Параметры описаны в таблице ниже:

параметрыобязательныйпримечание
fine_usernameбытьидентификатор пользователя
точный_парольбытькриптовалюта
зашифрованныйзасорениеЯвляется ли пароль зашифрованным шифротекстом**Значение равно true:**Пароль, введенный пользователем, должен быть зашифрован по алгоритму AES, прежде чем интерфейс можно будет использовать должным образом.Примечание: Рекомендуется использовать без шифрования, нет необходимости использовать этот параметр в интерфейсе
срок действиябыть**Значение равно -2:**означает "оставаться под своим логином". Срок пребывания под своим логином составляет 14 дней.**Значение равно -1:**Если вы не вошли в систему, продолжительность следует: Управление системой > Управление системой > Логины > Вход > Таймаут входаПримечание: Чтобы не выходить из системы при однократном входе, измените значение параметра validity на -2.
обратный вызовзасорение-

В браузере введите URL: http: //localhost:37799/webroot/decision/login/cross/domain?validity=-1&fine_username=账号&fine_password=密码, если он вернет & nbsp; success от имени единственного интерфейсного вызова success, как показано на рисунке:

2.png

2.2 Другие примечания

Другие примечания приведены ниже:

  • Этот интерфейс можно использовать не только для единой регистрации, но и для настройки экрана входа в систему. Более подробную информацию об интерфейсе можно найти в официальной документации к нему.
  • В платформе необходимо отключить кнопку "Защита от атак, связанных со сниффингом содержимого", а в случае встроенных iframe - кнопку "Защита от атак, связанных с перехватом". Описание кнопки см. в разделе: Безопасность
  • Токен, полученный при входе в систему, хранится в файле cookie. Убедитесь, что браузер не отключил токен, а OA или другие системы в том же домене не могут установить для cookie значение HttpOnly.
  • Поскольку информация о пользователе находится в url и могут появляться символы URL, рекомендуется кодировать ее один раз с помощью encodeURIComponent. Подробнее о преобразованиях кодировок см. в разделе: Преобразования кодировок
  • Для некоторых браузеров IE необходимо добавить целевой сайт в список доверенных.

2.3 Разница между Ajax и iframe

Оба метода входа iframe и Ajax могут реализовать единый вход в систему через домены, но Ajax может реализовать асинхронный единый вход и обрабатывать результаты проверки системы отчетов, такие как таймаут входа; однако iframe не может обрабатывать асинхронную обработку и не может обрабатывать результаты проверки при выполнении проверки отчета.