Используемые классы
В следующих разделах приводятся краткие сведения о классах, которые используются для разработки аутентификатора устройства Edge, и классах, используемых для добавления запросов безопасности к устройству Edge.
Классы расширения аутентификации устройства Edge
Следующие классы интерфейса API ThingWorx Platform используются при разработке расширения аутентификатора устройства Edge:
• SecurityClaimsAuthenticator - класс, используемый для реализации настраиваемой функциональности, включенной в расширение аутентификатора с помощью следующих методов.
 |
SecurityClaimsAuthenticator не предназначен для обработки HTTP-запросов и выдает исключительную ситуацию при их использовании.
|
◦ matchesAuthRequest - метод, который используется, чтобы определить, должны ли запросы безопасности, предоставляемые устройством Edge, обрабатываться расширением аутентификации.
Возвращает true, если существует успешное соответствие, в противном случае false.
◦ authenticate - метод, используемый для определения, как проверять запросы безопасности, предоставляемые устройством Edge для аутентификации с ThingWorx Platform.
Возвращает действительный идентификатор пользователя ThingWorx, который используется, чтобы определить разрешения, доступные для аутентифицируемого соединения.
• SecurityClaims - класс, используемый для управления настройками безопасности для соединений с платформой ThingWorx. Этот класс действует как оболочка для сопоставления учетных данных ключ-значение, предоставляемых устройством Edge. Для расширения аутентификатора SecurityClaims используется, чтобы передавать учетные данные в методы SecurityClaimsAuthenticator.
• AuthenticatorException - класс, который обрабатывает исключительные ситуации при аутентификации.
Добавление классов запросов безопасности устройства Edge
Следующий интерфейс API ThingWorx Platform и классы SDK ThingWorx Edge используются при добавлении запросов безопасности устройству Edge:
• APIClient - класс из ThingWorx Edge SDK, используемый для соединения устройства Edge через сервер API.
• ClientConfigurator - класс из ThingWorx Edge SDK, который используется устройством Edge, чтобы управлять его поведением и подключением к ThingWorx Platform.
• SecurityClaims - класс из API-интерфейса ThingWorx Platform, который используется для управления настройками безопасности для соединений с платформой ThingWorx. Этот класс действует как оболочка для сопоставления учетных данных ключ-значение, предоставляемых устройством Edge. Для устройства Edge SecurityClaims используется, чтобы отправлять учетные данные безопасности к расширению аутентификатора.