matlab.net.http.field.AuthenticateField class

Пакет: matlab.net.http.field
Суперклассы: matlab.net.http.HeaderField

WWW HTTP - Аутентифицирует, или Прокси - Аутентифицируют поле заголовка

Описание

AuthenticateField объект содержит один или несколько вызовов со стороны сервера, просящего информацию аутентификации. Сервер или прокси создают AuthenticateField в сообщении ответа.

Когда вы отправляете сообщение запроса в сервер или через прокси, который требует аутентификации, MATLAB® автоматически попытки аутентифицировать к серверу или прокси, когда:

  • HTTPOptions.Authenticate свойство верно (значение по умолчанию)

  • HTTPOptions.Credentials свойство содержит необходимые имена и пароли.

Если аутентификация успешна, то сообщение ответа возвращает OK состояние и не содержит поле аутентификации.

Если вы отключаете аутентификацию или если не пройдено аутентификация, то сообщение ответа возвращает поле аутентификации. В этом случае код статуса сообщения ответа любой 401 (Unauthorized) или 407 (ProxyAuthenticationRequired). Исследуйте AuthInfo возразите и ответьте путем добавления соответствующего AuthorizationField к сообщению запроса, содержащему ваши учетные данные. Или снова пошлите запрос путем установки правильного Credentials свойство в HTTPOptions.

Если сервер или прокси требуют схемы аутентификации, которую не поддерживает MATLAB, необходимо реализовать протокол аутентификации сами. Создайте сообщение запроса с соответствующими учетными данными и другой информацией.

Атрибуты класса

Sealed
true

Для получения информации об атрибутах класса см. Атрибуты класса.

Создание

Описание

пример

obj = matlab.net.http.field.AuthenticateField(name,value) создает поле заголовка аутентификации с Name набор свойств к name и Value набор свойств к value.

Сервер создает это поле в сообщении ответа. Используйте этого конструктора для тестовых целей.

Свойства

развернуть все

Имя поля заголовка в виде 'WWW-Authenticate' или 'Proxy-Authenticate'.

Атрибуты:

GetAccess
public
SetAccess
public

Список, разделенный запятыми проблем в виде вектора из matlab.net.http.AuthInfo объекты или строка в формате, заданном RFC 7235 и RFC 2617. Используйте AuthenticateField.convert метод, чтобы проанализировать это поле.

Атрибуты:

GetAccess
public
SetAccess
public
Dependent
true

Методы

развернуть все

Примеры

свернуть все

В этом примере показано, как установить схему аутентификации в сообщении запроса.

Задайте отображают URL

import matlab.net.*;
import matlab.net.http.*;

httpsUrl = "https://requestserver.mathworks.com";
uri = URI(strcat(httpsUrl, "/assets/computerVision.jpg?authenticate=digest"));

Установите учетные данные

Установите схему аутентификации на Digest и обеспечьте учетные данные входа в систему.

cred = Credentials("Scheme", "Digest", "Username", "testName", "Password", "testPass");
options = HTTPOptions;
options.Credentials = cred;
options.Authenticate = false;
req = RequestMessage('GET');
response = req.send(uri, options);
authenticateField = response.getFields("WWW-Authenticate");
disp(authenticateField)
  AuthenticateField with properties:

     Name: "WWW-Authenticate"
    Value: "Digest realm="Digest Authentication",qop="auth",nonce="0.3598425461739989",opaque="0d3ced1a5756977875a15f93cc12dd21""
Введенный в R2017b