matlab.net.http.AuthInfo类

包:matlab.net.http

HTTP消息中的身份验证或授权信息

全部展开页面

描述

MATLAB^®在中提供凭据时自动处理请求消息中的身份验证HTTPOptions对象。使用AuthInfo类以检查身份验证、指定授权信息或实现身份验证协议，例如OAuth，这不是由MATLAB HTTP接口自动处理的。

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

你叫的AuthenticateField.convert用于响应消息的方法。
将凭据插入AuthorizationField将报头字段转换为请求消息。当你存储AuthInfo对象在授权字段中，MATLAB会在需要时自动将值括在引号中，并根据需要插入转义字符。
服务器返回认证信息数据库中的数据AuthenticationInfoField头字段。

的AuthenticateField和AuthorizationField转换方法将每个名称=值将字段中的属性与参数财产。转义字符和值周围的引号将被删除。

有关详细信息，请参阅RFC 7235认证和RFC 2617主机Imp接口(用于基本和摘要身份验证)。

类属性

密封 符合事实的

有关类属性的信息，请参见类属性．

创建

描述

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．

输入参数

全部展开

`paramName`- - - - - -参数名称
字符串|特征向量

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

数据类型:烧焦|字符串

`paramValue`- - - - - -参数值
所需的类型`paramName`

参数值，指定为所需的类型paramName1.没有任何限制paramValue类型，但值必须支持金宝app字符串或烧焦方法

`pStruct`- - - - - -参数和值
MATLAB结构

参数和值，在MATLAB结构中指定为字段。该结构应至少具有计划领域MATLAB忽略了具有空值的字段。

数据类型:结构体

`pStr`- - - - - -参数和值
字符串

参数和值，指定为字符串。对于pStr语法:

如果pStr是证书还是挑战，看RFC 7235，第2.1节．
如果pStr是一个认证信息在身份验证信息标题中，请参阅RFC 2617，章节3.2.3．

pStr是这些格式之一。值可以选择用引号括起来，并根据需要插入转义字符。

SCHEME token SCHEME param1=value1, param2=value2，…param1 = value1, param2 = value2,…

数据类型:字符串

属性

全部展开

`计划`- - - - - -身份验证方案
`AuthenticationScheme。基本`(默认)|`matlab.net.http.AuthenticationScheme`对象|字符串|空

认证方案，指定为matlab.net.http.AuthenticationScheme对象或命名方案的字符串。

如果计划是字符串，然后MATLAB尝试将其转换为认证方案枚举。MATLAB不提供特殊的处理计划具有小于0的数值。
如果AuthInfo对象是一个挑战AuthenticateField标题字段和计划这不是一个认证方案那么是枚举吗计划这是一根绳子。否则计划是一个认证方案对象。
如果AuthInfo在一个AuthorizationField头字段,然后计划是一个认证方案对象。
如果AuthInfo在一个AuthenticationInfoField头字段,然后计划可能是空的。

属性：

`获取访问权限`	`平民的`
`SetAccess`	`平民的`

`参数`- - - - - -参数名称和值
n除以2单元阵列

参数名称和值，指定为n × 2单元格数组。参数{1},我是什么名字我参数，是一个字符串。参数{2},我是它的价值。类型取决于参数。要获取或设置此属性，请使用getParameter或设置参数方法。

的参数财产取决于财产计划属性及其后的属性计划在报头字段中。参数名匹配不区分大小写。使用addParameter，设置参数和移除参数方法来访问参数数组中。

一些参数属性具有特殊的含义和语法，MATLAB基于计划．这里列出了具有特殊含义的参数。所有其他参数为字符串对象。

如果计划是AuthenticationScheme。基本，则需要一个参数。
- 在一个AuthenticateField（来自服务器的质询），属性名称为领域. 服务器为用户提示提供领域，该领域与凭证。领域财产。一个AuthInfo返回的AuthenticateField.convert方法始终具有领域参数。
- 在一个AuthorizationField(来自客户端的响应中的凭据)，属性名称为编码的这个编码的属性是一个base64编码的字符序列，表示用户名和密码，显示在下面的标题字段中计划．如果设置了此参数，则必须使用base64编码函数。
如果计划是AuthenticationScheme.Digest，则属性的数量是可变的，对应于名称=值报头字段中的属性。
- 对于一个AuthenticateField，请参阅中列出的属性RFC 2617，第3.2.1节．
- 对于一个AuthorizationField，请参阅中列出的属性RFC 2617，章节3.2.2．
如果计划是其他任何认证方案属性或字符串，则所有属性名称和值都是可接受的，只要它们可以转换为字符串。

属性：

`获取访问权限`	`平民的`
`SetAccess`	`平民的`
`依靠的`	`符合事实的`

方法

全部展开

公共方法

`getParameter`	AuthInfo参数的返回值
`移除参数`	删除AuthInfo参数
`设置参数`	设置“AuthInfo”参数的值

专业操作员和功能

这些方法专门用于该类对象的标准MATLAB运算符和函数。

`情商`和`isequal`	两个`AuthInfo`如果: 他们有相同的`计划`属性和参数名称。参数名匹配不区分大小写。参数值等于使用`isequal`，而不考虑参数的顺序。两个值都必须是标量。
`字符串`	AuthInfo作为字符串显示在授权或身份验证标题字段中
`烧焦`	AuthInfo作为字符向量

另请参阅

外部网站

介绍了R2016b

matlab.net.http.AuthInfo类

描述

类属性

创建

描述