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

네임스페이스: matlab.net.http.field
슈퍼클래스: matlab.net.http.HeaderField

HTTP의 Authorization 헤더 필드 또는 Proxy-Authorization 헤더 필드

설명

서버에서 반환되는 AuthenticateField의 인증 질문에 대한 응답으로써 요청 메시지의 자격 증명이 AuthorizationField 객체에 포함됩니다. 자격 증명은 AuthInfo 객체의 형식을 취합니다. 자세한 내용은 RFC Editor 웹사이트의 RFC 7235 section 4.2 Authorization 및 section 4.4 Proxy-Authorization을 참조하십시오.

MATLAB^®은 다음과 같은 경우 이 필드를 자동으로 생성합니다.

요청 메시지에서 HTTPOptions.Authenticate 속성이 true(디폴트 값)인 경우.
HTTPOptions.Credentials 속성에 적절한 자격 증명을 지정한 경우.
MATLAB이 서버에서 요청하는 인증 체계를 지원하는 경우.

자동 인증을 사용하지 않도록 설정하거나 지원되지 않는 인증 프로토콜을 구현하는 경우에는 이 필드를 명시적으로 생성해야 합니다. 이 필드를 명시적으로 생성하는 경우에는 Value 속성을 유효한 승인 문자열이나 AuthInfo 객체로 설정하십시오.

자동 인증을 위해 서버로 전송된 AuthorizationField를 보려면 RequestMessage.send 메서드에서 반환되는 완료된 요청이나 내역 인수를 검토하십시오.

클래스 특성

Sealed true

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

생성

설명

obj = matlab.net.http.field.AuthorizationField(name,value)는 Name 속성은 name으로, Value 속성은 value로 설정하여 승인 헤더 필드를 생성합니다. 자동 인증을 사용하지 않도록 설정했거나 지원되지 않는 인증 프로토콜을 구현하려는 경우에는 이 필드를 생성하십시오.

예제

속성

모두 확장

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

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

특성:

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

`Value` — 승인
문자열 | `matlab.net.http.AuthInfo` 객체

승인으로, 유효한 승인 문자열이나 matlab.net.http.AuthInfo 객체로 지정됩니다.

특성:

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

메서드

모두 확장

퍼블릭 메서드

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

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

convert

AuthorizationField의 Value 속성을 AuthInfo 객체로 구성된 벡터로 반환합니다.

AuthorizationField별로 하나의 AuthInfo 객체가 대응됩니다. AuthorizationField 객체로 구성된 벡터를 전달하면 convert는 AuthInfo 객체로 구성된 동일한 크기의 벡터를 반환합니다. AuthInfo에 포함된 파라미터들은 AuthorizationField에 포함된 자격 증명의 파라미터들과 일치하게 됩니다. 구성되는 파라미터의 종류는 필드 내 첫 번째 토큰인 AuthInfo.Scheme 속성에 따라 달라집니다.

특화된 연산자와 함수

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

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

예제

모두 축소

자격 증명 제공하기

라이브 스크립트 열기

이 예제에서는 사용자 이름과 비밀번호를 웹 서버로 전달하는 방법을 보여줍니다.

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

httpsUrl = 'https://requestserver.mathworks.com';
cred = Credentials('Scheme', 'Digest', 'Username', 'testName', 'Password', 'testPass');
uri = URI(strcat(httpsUrl, '/assets/computerVision.jpg?authenticate=digest'));
options = HTTPOptions;
options.Credentials = cred;
req = RequestMessage('GET');
[~, completedRequest, ~] = req.send(uri, options);
authorizationField = completedRequest.getFields("Authorization");
disp(authorizationField)

  AuthorizationField with properties:

     Name: "Authorization"
    Value: "Digest username="testName",realm="Digest Authentication",nonce="0.10850025543344421",uri="/assets/computerVision.jpg?authenticate=digest",cnonce="3abc9b6ff07a1e6e6b261f50a40b16cd",nc=00000001,response="3bd7d2e24c3bf3e3e5ea78628c1ccf76",qop="auth",opaque="0d3ced1a5756977875a15f93cc12dd21""

요청에서 AuthorizationField 자격 증명 보기

import matlab.net.http.*
creds = Credentials('Username','MyName','Password','MyPassword');
options = HTTPOptions('Credentials', creds);
[response, request] = RequestMessage().send('http://myhost.com',options);
authorizationField = request.getFields('Authorization');
authInfo = authorizationField.convert;
disp(string(authInfo));

버전 내역

R2016b에 개발됨