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 Hypertext Transfer Protocol (HTTP/1.1): Authentication 및 RFC 2617 HTTP Authentication: IETF^®(Internet Engineering Task Force) 웹사이트의 RFC 2617 HTTP Authentication: Basic and Digest Access Authentication을 참조하십시오. 이 필드를 구문 분석하려면 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에 개발됨

참고 항목

AuthInfo | RequestMessage | ResponseMessage | HTTPOptions | Credentials | StatusCode | matlab.net.http.field.AuthorizationField