Main Content

matlab.net.http.AuthInfo 클래스

네임스페이스: matlab.net.http

HTTP 메시지의 인증 또는 승인 정보

페이지 내 모두 확장

설명

HTTPOptions 객체에 자격 증명을 제공하면 MATLAB®에서 요청 메시지에 있는 인증을 자동으로 처리합니다. AuthInfo 클래스를 사용하여 인증을 검토하거나, 승인 정보를 지정하거나, MATLAB HTTP 인터페이스에서 자동으로 처리되지 않는 OAuth 같은 인증 프로토콜을 구현할 수 있습니다.

AuthInfo 클래스는 다음과 같은 경우 반환되는 하나의 인증 질문을 나타냅니다.

  • 응답 메시지에 대해 AuthenticateField.convert 메서드를 호출할 때.

  • 요청 메시지의 AuthorizationField 헤더 필드에 자격 증명을 삽입할 때. 승인 필드에 AuthInfo 객체를 저장하면 MATLAB에서 필요에 따라 자동으로 값을 따옴표로 묶고 이스케이프 문자를 삽입합니다.

  • 서버가 AuthenticationInfoField 헤더 필드에 auth-info 데이터를 반환할 때.

AuthenticateField 및 AuthorizationField의 convert 메서드는 필드의 각 name=value 쌍 특성을 Parameters 속성의 파라미터 이름-값 쌍으로 변환합니다. 이스케이프 문자와 값을 둘러싸는 따옴표는 제거됩니다.

자세한 내용은 IETF®(Internet Engineering Task Force) 웹사이트의 RFC 7235 Authentication 및 RFC 2617 Host-Imp Interface(기본 인증 및 다이제스트 인증용)를 참조하십시오.

클래스 특성

Sealed
true

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

생성

설명

obj = matlab.net.http.AuthInfo(Scheme,paramName,paramValue)는 Scheme 속성과 paramName, paramValue 파라미터(선택 사항)를 포함하는 AuthInfo 객체를 생성합니다. paramName1,paramValue1,...,paramNameN,paramValueN과 같이 여러 개의 인수 쌍을 어떤 순서로든 지정할 수 있습니다.

obj = matlab.net.http.AuthInfo(paramName,paramValue)는 빈 Scheme 값을 갖는 AuthInfo 객체를 생성합니다.

obj = matlab.net.http.AuthInfo(pStruct)는 pStruct의 필드에서 파라미터와 값을 복사합니다.

obj = matlab.net.http.AuthInfo(pStr)은 pStr에서 AuthInfo를 생성합니다.

입력 인수

모두 확장

파라미터 이름으로, string형이나 문자형 벡터로 지정됩니다. 웹 서비스는 요청의 일부로 받는 paramName,paramValue 쌍을 정의합니다. paramName 인수는 AuthInfo 객체를 문자열로 변환할 때 name=value 파라미터로 변환되는 파라미터를 나타냅니다.

데이터형: char | string

파라미터 값으로, paramName에 필요한 유형으로 지정됩니다. paramValue 유형에 대한 제약 조건은 없지만, 값은 string 메서드나 char 메서드를 지원해야 합니다.

파라미터와 값으로, MATLAB 구조체 내 필드로 지정됩니다. 구조체에는 적어도 하나의 Scheme 필드가 있어야 합니다. MATLAB은 빈 값이 있는 필드를 생략합니다.

데이터형: struct

파라미터와 값으로, string형으로 지정됩니다. pStr 구문:

  • pStr이 자격 증명이거나 인증 질문인 경우 RFC 7235 Authentication section 2.1을 참조하십시오.

  • pStr이 Authentication-Info 헤더의 auth-info인 경우 RFC 2617 Host-Imp Interface section 3.2.3을 참조하십시오.

pStr은 다음 형식 중 하나입니다. 필요에 따라 값이 따옴표로 묶이고 이스케이프 문자가 삽입됩니다.

SCHEME token
SCHEME param1=value1, param2=value2, ...
param1=value1, param2=value2, ...

데이터형: string

속성

모두 확장

인증 체계로, matlab.net.http.AuthenticationScheme 객체나 이 체계를 명명하는 string형으로 지정됩니다.

  • Scheme이 string형이면 MATLAB은 이를 AuthenticationScheme 열거형으로 변환하려고 시도합니다. MATLAB은 0 미만의 숫자 값을 갖는 Scheme에 대해 특정한 처리 방법을 제공하지 않습니다.

  • AuthInfo 객체가 AuthenticateField 헤더 필드의 인증 질문이고 Scheme이 AuthenticationScheme 열거형이 아닌 경우 Scheme은 string형입니다. 그렇지 않은 경우 Scheme은 AuthenticationScheme 객체입니다.

  • AuthInfo가 AuthorizationField 헤더 필드에 있는 경우 Scheme은 AuthenticationScheme 객체입니다.

  • AuthInfo가 AuthenticationInfoField 헤더 필드에 있는 경우 Scheme이 비어 있을 수 있습니다.

특성:

GetAccess
public
SetAccess
public

파라미터 이름과 파라미터 값으로, n×2 셀형 배열로 지정됩니다. Parameters{i,1}은 i번째 파라미터의 이름이며 string형입니다. Parameters{i,2}는 해당 값입니다. 값 유형은 파라미터에 따라 달라집니다. 이 속성을 가져오거나 설정하려면 getParameter 메서드나 setParameter 메서드를 사용하십시오.

Parameters 속성은 Scheme 속성과 헤더 필드에서 Scheme 다음에 오는 특성에 따라 달라집니다. 파라미터 이름 일치에서는 대/소문자를 구분하지 않습니다. Parameters 배열의 값에 액세스하려면 addParameter, setParameter, removeParameter 메서드를 사용하십시오.

일부 파라미터 속성에는 MATLAB에서 Scheme을 기반으로 하여 적용하는 특별한 의미와 구문이 있습니다. 아래에 특별한 의미가 있는 파라미터가 나열되어 있습니다. 다른 모든 파라미터는 string 객체입니다.

  • Scheme이 AuthenticationScheme.Basic인 경우 파라미터 하나가 필요합니다.

    • AuthenticateField(서버에서 반환하는 인증 질문)에서 속성 이름은 realm입니다. 서버는 사용자 프롬프트에 대한 realm 속성을 제공하며, 이는 Credentials.Realm 속성과 일치합니다. AuthenticateField.convert 메서드에서 반환되는 AuthInfo는 항상 realm 파라미터를 가집니다.

    • AuthorizationField(클라이언트의 응답에 포함된 자격 증명)에서 속성 이름은 encoded입니다. Encoded 속성은 base64로 인코딩된 일련의 문자로서 헤더 필드에 Scheme 다음에 표시된 사용자 이름과 비밀번호를 나타냅니다. 이 파라미터를 설정한 경우 base64encode 함수를 사용하여 직접 인코딩해야 합니다.

  • Scheme이 AuthenticationScheme.Digest인 경우, 속성 개수는 가변적이며 헤더 필드의 name=value 특성에 대응됩니다.

    • AuthenticateField에 대해서는 RFC 2617 Host-Imp Interface section 3.2.1에 나와 있는 속성을 참조하십시오.

    • AuthorizationField에 대해서는 RFC 2617 Host-Imp Interface section 3.2.2에 나와 있는 속성을 참조하십시오.

  • Scheme이 그 외의 AuthenticationScheme 속성이나 string형으로 설정된 경우, 모든 특성 이름과 특성 값은 문자열로 변환이 가능한 경우에 한해 허용됩니다.

특성:

GetAccess
public
SetAccess
public
Dependent
true

메서드

모두 확장

버전 내역

R2016b에 개발됨

참고 항목

| | | | | |