Пакет: matlab.net.http
Суперклассы: handle
Учетные данные для аутентификации запросов HTTP
Credentials
класс задает учетные данные аутентификации для отправки сообщения запроса. Задайте Credentials
объект в HTTPOptions
объект.
RequestMessage.send
метод использует учетные данные, чтобы ответить на запросы аутентификации с серверов или прокси. Запрос аутентификации находится в AuthenticateField
поле заголовка и задает одну или несколько схем аутентификации, которые сервер или прокси принимают, чтобы удовлетворить запросу.
Поведение зависит от схемы аутентификации. In general, MATLAB® ищет вектор из Credentials
объекты для того, который применяется к URI запроса и который поддерживает заданную схему аутентификации. MATLAB затем снова посылает исходный запрос с соответствующими учетными данными в AuthorizationField
заголовок. Если несколько учетных данных применяются, то MATLAB использует самый определенный Credentials
объект для самой сильной схемы. Если дублирующийся Credentials
объекты существуют, затем MATLAB использует первый.
Чтобы видеть что схемы аутентификации реализации MATLAB автоматически, смотрите AuthenticationScheme
. Если сервер требует других схем, или вы не предоставляете учетные данные для необходимой схемы, то сообщение ответа на запрос аутентификации возвращает StatusCode 401 или 407. В этом случае необходимо реализовать соответствующий ответ сами.
Для схем, которые не требуют Username
и Password
свойства, такие как NTLM на Windows®, можно использовать Credentials
по умолчанию объект.
Credentials
по умолчанию объект имеет или пустые свойства по умолчанию и применяется ко всем поддерживаемым схемам и URIs. Ваши учетные данные авторизации прибывают из информации, такой как билеты Kerberos, которые хранятся в вашей системе, когда вы входите в систему. Чтобы ограничить условия, при которых используется конкретная схема, можно задать дополнительные свойства, такие как Осциллограф и Область. Например, установите эти значения, чтобы использовать NTLM для некоторых URL и Kerberos для других и отклонить запросы аутентификации с серверов, которые не совпадают с теми URL и схемами.
Для схем, которые требуют Username
и Password
свойства, если MATLAB аутентифицирует с Credentials
объект, затем MATLAB сохраняет результаты в этом объекте. MATLAB может применить эти учетные данные на последующие запросы, не ожидая запроса аутентификации с сервера. Чтобы использовать в своих интересах ярлык, обеспечьте тот же Credentials
объект по последующим запросам в том же самом или другом HTTPOptions
объекты.
Credentials
объекты являются объектами указателя и внутренне накапливают информацию о предшествующих успешных аутентификациях. Поэтому можно снова использовать информацию для последующих сообщений. Если вы вставляете этот объект в несколько HTTPOptions
объекты, затем Credentials
объектная сила быть обновленным после каждого использования. Если вы копируете Credentials
использование его copy
метод, затем MATLAB копирует только свойства видимости, которые вы устанавливаете, а не внутреннее состояние.
matlab.net.http.Credentials
классом является handle
класс.
obj = matlab.net.http.Credentials(Name,Value)
создает учетные данные HTTP с дополнительными свойствами, заданными одним или большим количеством аргументов пары "имя-значение". Name
имя свойства и Value
соответствующее значение. Можно задать несколько аргументов пары "имя-значение" в любом порядке как Name1,Value1,...,NameN,ValueN
. Незаданные свойства установлены в свои значения по умолчанию.
Если вы вызываете этого конструктора без аргументов, то Credentials
объект применяется и таким образом разрешает аутентификацию для всего URIs и всех схем аутентификации. Однако объект работает только на схемы, которые не требуют имени пользователя или пароля. Например, на Windows, объект включает NTLM и аутентификацию Kerberos с помощью учетных данных зарегистрированного пользователя.
AuthenticationScheme
| HTTPOptions
| RequestMessage
| StatusCode