matlab.net.http.field.AuthenticateField 클래스

패키지: matlab.net.http.field
슈퍼클래스: matlab.net.http.HeaderField

HTTP의 WWW-Authenticate 헤더 필드 또는 Proxy-Authenticate 헤더 필드

설명

AuthenticateField 객체에는 서버에서 반환되어 인증 정보를 묻는 하나 또는 복수의 인증 질문이 포함됩니다. 서버나 프록시는 응답 메시지에 AuthenticateField를 생성합니다.

인증을 필요로 하는 서버로 또는 프록시를 통해 요청 메시지를 전송하면 MATLAB^®은 다음과 같은 경우 서버나 프록시를 자동으로 인증하려고 시도합니다.

HTTPOptions.Authenticate 속성이 true(디폴트 값)인 경우.
HTTPOptions.Credentials 속성이 필요한 이름과 비밀번호를 포함하는 경우.

인증이 성공하면 응답 메시지가 OK 상태를 반환하고 인증 필드를 포함하지 않습니다.

인증을 사용하지 않도록 설정했거나 인증이 실패한 경우 응답 메시지가 인증 필드를 반환합니다. 이 경우, 응답 메시지의 상태 코드는 401(Unauthorized) 또는 407(ProxyAuthenticationRequired)입니다. 자격 증명을 포함하는 요청 메시지에 적합한 AuthorizationField를 추가하여 AuthInfo 객체와 응답을 검토하십시오. 또는 HTTPOptions에 올바른 Credentials 속성을 설정하여 요청을 다시 전송하십시오.

서버나 프록시가 MATLAB이 지원하지 않는 인증 체계를 요구하는 경우, 인증 프로토콜을 직접 구현해야 합니다. 적합한 자격 증명과 기타 정보를 사용하여 요청 메시지를 생성하십시오.

클래스 특성

Sealed true

클래스 특성에 대한 자세한 내용은 클래스 특성 항목을 참조하십시오.

생성

설명

예제

obj = matlab.net.http.field.AuthenticateField(name,value)는 Name 속성은 name으로, Value 속성은 value로 설정하여 인증 헤더 필드를 생성합니다.

서버는 응답 메시지에 이 필드를 생성합니다. 테스트 목적으로 이 생성자를 사용하십시오.

속성

모두 확장

`Name` — 헤더 필드 이름
`'WWW-Authenticate'` | `'Proxy-Authenticate'`

헤더 필드 이름으로, 'WWW-Authenticate' 또는 'Proxy-Authenticate'로 지정됩니다.

특성:

`GetAccess`	`public`
`SetAccess`	`public`

`Value` — 인증 질문
`AuthInfo` 객체의 벡터 | string형

쉼표로 구분된 인증 질문 목록으로, matlab.net.http.AuthInfo 객체로 구성된 벡터나 RFC 7235와 RFC 2617에 정의된 형식의 string형으로 지정됩니다. 이 필드를 구문 분석하려면 AuthenticateField.convert 메서드를 사용하십시오.

특성:

`GetAccess`	`public`
`SetAccess`	`public`
`Dependent`	`true`

메서드

모두 확장

퍼블릭 메서드

`addFields`	HeaderField 배열에 필드 추가
`removeFields`	헤더 필드 배열에서 필드 제거
`changeFields`	HeaderField 배열의 기존 값 변경
`replaceFields`	HeaderField 배열의 값 변경 또는 HeaderField 배열에 필드 추가
`getFields`	이름이나 클래스가 일치하는 헤더 필드 반환
`eq`	두 개의 HeaderField 배열 비교
`convertLike`	다른 헤더 필드와 유사하게 헤더 필드 값 변환
`parse`	헤더 필드 값을 구문 분석하고 string형으로 반환
`displaySubclasses`	지원되는 HeaderField 서브클래스 표시

서브클래스에 대해 특화된 메서드

convert

AuthenticateField의 Value 속성을 AuthenticateField에 나타나는 순서대로 헤더 필드에 포함된 각 인증 질문에 대해 하나씩 AuthInfo 객체의 벡터로 반환합니다.

특화된 연산자와 함수

다음 메서드는 표준 MATLAB 연산자와 함수를 이 클래스의 객체를 위해 특화합니다.

`isequal`	`eq` 메서드에서 설명하는 것처럼, 두 헤더 필드 배열이 크기가 같고 대응되는 요소가 동일하면 `true`를 반환합니다.
`string`	헤더 필드로 구성된 배열을 메시지에 나타나는 대로 string형으로 반환합니다. 새 줄 문자가 필드와 필드 사이에 삽입되지만, 모든 필드의 끝에는 삽입되지 않습니다.
`char`	헤더 필드로 구성된 배열을 `string` 메서드에서 설명한 것처럼 문자형 벡터로 반환합니다.

예제

모두 축소

인증 제공하기

라이브 스크립트 열기

이 예제에서는 요청 메시지에서 인증 체계를 설정하는 방법을 보여줍니다.

이미지 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""

버전 내역

R2016b에 개발됨

참고 항목