主要内容

matlab.net.http.AuthInfo类

包:matlab.net.http

在HTTP消息身份验证或授权信息

扩展所有的页面

描述

MATLAB®自动处理身份验证请求消息,当你在一个提供凭证HTTPOptions对象。使用AuthInfo类检查身份验证、指定授权信息,或实现一个认证协议,如OAuth,这不是由MATLAB HTTP接口自动处理。

的AuthInfo类代表一个身份验证的挑战时返回:

  • 你叫的AuthenticateField.convert响应消息的方法。

  • 你在一个插入的凭证AuthorizationField请求消息头字段。当存储一个AuthInfo对象在一个授权领域,MATLAB自动报价中需要包含值,并根据需要插入转义字符。

  • 服务器返回auth-info中的数据AuthenticationInfoField头字段。

的AuthenticateField和AuthorizationField转换方法将每个名称=值对属性字段的参数名称和值对参数财产。转义字符和周围任何引用值删除。

有关更多信息,请参见RFC 7235认证和RFC 2617 Host-Imp界面(基本和摘要式身份验证)因特网工程任务组(IETF)®)的网站。

类属性

密封
真正的

类属性的信息,请参阅类属性。

创建

描述

obj = matlab.net.http.AuthInfo(计划,paramName,paramValue)创建一个AuthInfo对象包括计划财产和可选的paramName,paramValue参数。您可以指定一些参数对在任何顺序paramName1, paramValue1,…, paramNameN paramValueN。

obj = matlab.net.http.AuthInfo (paramName,paramValue)创建一个AuthInfo与一个空对象计划价值。

obj = matlab.net.http.AuthInfo (pStruct)复制参数和值的字段pStruct。

obj = matlab.net.http.AuthInfo (pStr)创建一个AuthInfo从pStr。

输入参数

全部展开

参数名称,指定为一个字符串或一个字符向量。web服务定义paramName, paramValue对,它接受一个请求的一部分。一个paramName参数表示转换为参数名称=值当你把一个参数AuthInfo一个字符串对象。

数据类型:字符|字符串

所需要的参数值,指定为一个类型paramName。没有限制paramValue类型,但是必须支持一个值金宝app字符串或字符方法。

参数和值,指定为MATLAB结构中的字段。至少要有一个结构计划字段。MATLAB省略了字段空值。

数据类型:结构体

参数和值,指定为字符串。为pStr语法:

  • 如果pStr是一个凭证或挑战,那么见2.1节RFC 7235认证。

  • 如果pStr是一个auth-infoAuthentication-Info头,然后看到RFC 2617 Host-Imp接口部分3.2.3。

pStr是这些格式之一。值可以包含在引号和转义字符插入。

计划令牌方案param1 = value1, param2 = value2,…param1 = value1, param2 = value2,…

数据类型:字符串

属性

全部展开

身份验证方案,指定为一个matlab.net.http.AuthenticationScheme对象或一个字符串命名方案。

  • 如果计划MATLAB是一个字符串,然后试图将它转换成一个AuthenticationScheme枚举。MATLAB不提供特殊处理计划与数值小于0。

  • 如果AuthInfo在一个对象是一个挑战AuthenticateField头字段和计划不是一个AuthenticationScheme枚举,然后计划是一个字符串。否则,计划是一个AuthenticationScheme对象。

  • 如果AuthInfo是在一个AuthorizationField头字段,然后计划是一个AuthenticationScheme对象。

  • 如果AuthInfo是在一个AuthenticationInfoField头字段,然后计划可能是空的。

属性:

GetAccess
公共
SetAccess
公共

参数名称和值,指定为n除以2细胞数组。参数{1},我的名称是什么我参数和是一个字符串。参数{2},我是它的价值。取决于参数类型。获取或设置此属性,使用getParameter或setParameter方法。

的参数性质取决于计划属性和属性计划头字段。参数名称匹配是不区分大小写的。使用addParameter,setParameter,removeParameter方法访问中的值参数数组中。

一些参数属性都有特殊的含义和语法,MATLAB执行基于计划。这里列出参数有特殊含义。所有其他参数都字符串对象。

  • 如果计划是AuthenticationScheme.Basic,然后一个参数。

    • 在一个AuthenticateField从一个服务器(挑战),属性名领域。服务器为用户及时提供领域,这是匹配的Credentials.Realm财产。一个AuthInfo返回的AuthenticateField.convert总是有一个域参数的方法。

    • 在一个AuthorizationField(响应从客户端凭据),属性名编码。的编码属性是一个base64编码的字符序列代表了用户名和密码,因为它出现在头字段计划。如果你设定这个参数,那么你必须自己动手编码使用base64encode函数。

  • 如果计划是AuthenticationScheme.Digest,那么属性变量和对应的数量名称=值头字段属性。

    • 对于一个AuthenticateFieldRFC 2617,看属性中列出Host-Imp 3.2.1接口部分。

    • 对于一个AuthorizationFieldRFC 2617,看属性中列出Host-Imp 3.2.2接口部分。

  • 如果计划是其他任何AuthenticationScheme财产或一个字符串,那么所有属性名称和值是可以接受的,只要他们可以转换为字符串。

属性:

GetAccess
公共
SetAccess
公共
依赖
真正的

方法

全部展开

版本历史

介绍了R2016b

另请参阅

||||||