Пакет: matlab.net.http
Суперклассы: handle
Учетные данные для аутентификации запросов HTTP
Класс Credentials
задает учетные данные аутентификации для отправки сообщения запроса. Задайте объект Credentials
в объекте HTTPOptions
.
Метод RequestMessage.send
использует учетные данные, чтобы ответить на запросы аутентификации с серверов или прокси. Запрос аутентификации находится в поле заголовка AuthenticateField
и задает одну или несколько схем аутентификации, которые сервер или прокси принимают, чтобы удовлетворить запрос.
Поведение зависит от схемы аутентификации. В целом MATLAB® ищет вектор объектов Credentials
для того, который применяется к URI запроса и который поддерживает заданную схему аутентификации. MATLAB затем снова посылает исходный запрос с соответствующими учетными данными в заголовке AuthorizationField
. Если несколько учетных данных применяются, то MATLAB использует самый определенный объект Credentials
для самой сильной схемы. Если дублирующиеся объекты Credentials
существуют, то MATLAB использует первый.
MATLAB только реализует схемы аутентификации Digest
и Basic
. Если сервер требует других схем, или вы не предоставляете учетные данные для необходимой схемы, то сообщение ответа на запрос аутентификации возвращает объект StatusCode
401 или 407. В этом случае необходимо реализовать соответствующий ответ сами.
После успешной аутентификации MATLAB сохраняет информацию в объекте Credentials
. Если вы применяете эти учетные данные на последующие запросы к тому же серверу, то MATLAB не ожидает запроса аутентификации с сервера. Чтобы применить учетные данные, обеспечьте тот же объект Credentials
для каждого запроса.
Объекты 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
. Незаданные свойства установлены в свои значения по умолчанию.
AuthenticationScheme
| HTTPOptions
| RequestMessage
| StatusCode