本页采用了机器翻译。点击此处可查看最新英文版本。

prodserver.addon.accessTokenPolicy

设置用户授权的访问令牌策略

全页折叠

    语法

    prodserver.addon.accessTokenPolicy(host,port,token,Name,Value)
    prodserver.addon.accessTokenPolicy(host,port,token)

    说明

    prodserver.addon.accessTokenPolicy(host,port,token,Name,Value) 使用一个或多个名称-值参量设置 Azure® Active Directory (Azure AD)凭据以进行用户授权，并设置令牌生成策略以授权使用 MATLAB® Production Server™ 附加功能的用户与在 host:port 运行的服务器进行通信。

    此函数需要 MATLAB Client for MATLAB Production Server。

    示例

    prodserver.addon.accessTokenPolicy(host,port,token) 设置令牌生成策略或设置持有者令牌的值，以授权使用 MATLAB Production Server 附加功能的用户与在 host:port 运行的服务器进行通信。

    示例

    示例

    全部折叠

    要使用系统生成的持有者令牌，您必须使用名称值参量设置 Azure AD 应用程序注册凭据。

    首先，确保服务器上启用了访问控制。有关详细信息，请参阅应用程序访问控制。

    确保已部署应用程序的 MATLAB Production Server 附加功能已安装在客户端计算机上。有关安装附加功能的更多信息，请参阅执行已部署的 MATLAB 函数。

    将系统设置为自动生成持有者令牌，用于向在 localhost 和端口 57142 上运行的服务器发出请求，并指定 Azure AD 应用程序注册凭据以供用户授权。

    prodserver.addon.accessTokenPolicy('localhost',57142,'automatic',...
'ClientID','0d912326-e439-41d0-822c-b15asdf6137c3',...
'ServerID','dwe4581bf-7867-4b90-a05a-16be6a82flkh',...
'IssuerURI','https://login.microsoftonline.com/yourcompany.com')

    通常，您会为每个服务器实例设置一次 Azure AD 应用程序注册凭据。

    指定与服务器通信时使用的持有者令牌。

    首先，在服务器上启用访问控制。有关详细信息，请参阅应用程序访问控制。

    确保已部署应用程序的 MATLAB Production Server 附加功能已安装在客户端计算机上。有关安装附加功能的更多信息，请参阅执行已部署的 MATLAB 函数。

    指定在对运行于 IP 地址 10.2.2.5 和端口 57142 的服务器的请求中使用的持有者令牌 'bearer_token_value'。

    prodserver.addon.accessTokenPolicy('10.2.2.5',57142,'bearer_token_value')

    指定当服务器上未启用访问控制时不需要持有者令牌。

    确保已部署应用程序的 MATLAB Production Server 附加功能已安装在客户端计算机上。有关安装附加功能的更多信息，请参阅执行已部署的 MATLAB 函数。

    将系统设置为不生成持有者令牌，以用于对在 IP 地址 10.2.2.5 和端口 57142 上运行的服务器的请求。

    prodserver.addon.accessTokenPolicy('10.2.2.5',57142,'none')

    输入参数

    全部折叠

    托管可部署存档的服务器（从中安装附加功能）的主机名，指定为字符向量或字符串标量。

    示例: '144.213.5.7'

    数据类型: char | string

    托管可部署存档的服务器（从中安装附加功能）的端口号，指定为正标量。

    示例: 9920

    数据类型: uint8 | uint16

    访问令牌策略，指定为字符向量或字符串标量。设置令牌生成策略或指定持有者令牌以在与服务器通信时授权用户。可能的选项如下：

    • 'automatic' - 使用登录到客户端计算机的用户的用户凭据生成持有者令牌。必须设置 Azure AD 应用程序注册凭据才能使用此策略。

    • 'none' - 不生成访问令牌。该值是默认值。

    • 字符向量或字符串标量 - 指定要用作持有者令牌的值。

    如果服务器上启用了访问控制，则必须将策略设置为 'automatic' 或指定持有者令牌。

    示例: 'automatic'

    示例: 'none'

    示例: 'AAAAAAAAAABBBBAAAAAAAMLheAAAAAAA0%2BuSepl%2BULvsea4JtiGRiSDSJSI%3DEUifiRmndf5E2XzMDjRfl76ZC9Ub0wnz4XsNiRVBChTYbJcE3F'

    数据类型: char | string

    名称-值参数

    全部折叠

    以 Name1=Value1,...,NameN=ValueN 的形式指定可选参量对组，其中 Name 是参量名称，Value 是对应的值。名称-值参量必须出现在其他参量之后，但对各个参量对组的顺序没有要求。

    如果使用的是 R2021a 之前的版本，请使用逗号分隔每个名称和值，并用引号将 Name 引起来。

    示例: 'ClientID','d17lk1bf-7977-4c90-a95a-16by7982fbaf', 'ServerID', 'd7pj91bf-7977-4b90-a05a-17vy5s82fbaf','IssuerURI','https://login.microsoftonline.com/your_organization_tenantID'

    在 Azure AD 中注册的客户端应用程序的应用程序 ID，用于用户授权，指定为字符向量或字符串标量。

    示例: 'ClientID','d17lk1bf-7977-4c90-a95a-16by7982fbaf'

    数据类型: char | string

    在 Azure AD 中注册的用于用户授权的服务器应用程序的应用程序 ID，指定为字符向量或字符串标量。

    示例: 'ServerID','d7pj91bf-7977-4b90-a05a-17vy5s82fbaf'

    数据类型: char | string

    用于生成持有者令牌的 URI，指定为字符向量或字符串标量。对于 Azure AD，IssuerURI 是 https://login.microsoftonline.com/ 后跟 Azure AD 租户 ID。

    示例: 'IssuerURI','https://login.microsoftonline.com/your_organization_tenantID'

    数据类型: char | string

    版本历史记录

    在 R2020b 中推出

    另请参阅

    主题