要使用身份验证,您需要在服务器上启用SSL。有关更多信息,请参见启用SSL.
验证允许您验证用户的凭据,并帮助您控制哪些用户可以访问部署在服务器上的Web应用程序。
马铃薯®Web应用程序服务器™金宝app使用轻量级目录访问协议(LDAP)和OpenID Connect(OIDC)支持身份验证。
要启用身份验证:
检查SSL是否已启用。有关更多信息,请参见启用SSL.
创建一个名为webapps_authn.json.
然后把它放在webapps_private
文件夹,位于内部配置
文件夹中。的格式webapps_authn.json.
取决于您是否使用LDAP或OIDC进行身份验证。
的webapps_private
文件夹可于以下网址找到:
操作系统 | 文件夹位置 |
---|---|
视窗® |
|
Linux® |
|
苹果系统 |
|
LDAP目录服务器存储用户、组和应用等信息。目录中的每个条目由三个组件组成:一个区别名称(DN)、一组属性和一组对象类。
要使用LDAP身份验证,请创建一个名为的文件webapps_authn.json.
使用下面的JSON模式,并将其放在webapps_private
文件夹中。
{"version": "1.0.0", "type": "ldap", "authnConfig": {"host": "< ldap服务器主机名>","port": "< ldap服务器端口号>","searcherDN": "", "searcherPassword": "", "baseDN": "< ldap中从哪里开始搜索用户>","userFilter": "<过滤语法>"},"appConfig": {"checkSSLCA":"","trustedSSLCA": "<受信任的SSL证书>的路径","displayName": "<在MATLAB Web App Server主页上显示的标识符>","tokenExpirationMin": ""}}
版本:指定JSON模式的版本。默认值为R2020A是:1.0.0
.
类型:指定要使用的身份验证类型。将此值设置为LDAP.
.
主持人:指定LDAP目录服务器主机名。例如:myldap.myboston.com.
.
港口:(可选的)指定LDAP目录服务器端口号。例如:389
.如果不指定端口号,则使用默认端口号。的MATLAB Web应用服务器使用SSL/STARTTLS与LDAP服务器进行安全通信。这确保用户名和密码之间通过加密通道传输MATLAB Web应用服务器和LDAP服务器。默认情况下,服务器使用标准端口636.
对于Windows和Port上的SSL389
在Linux和苹果系统.LDAP服务器必须配置为允许通过指定的(或默认的)LDAP端口进行SSL/STARTTLS连接;否则,认证将失败。
searcherDN:指定目录中的搜索器帐户DN。默认值为""
.搜索者DN是指允许搜索LDAP目录服务器的帐户。例如:“cn = admin, dc = myboston, dc = com”
.
SearcherPassword.:搜索者帐户的密码。默认值为""
.
MATLAB Web应用服务器使用值searcherDN
和SearcherPassword.
查找用户的DNUserfilter.
.随后通过LDAP与输入的密码一起验证发现的DN。价值searcherDN
和SearcherPassword.
如果LDAP服务器提供访问匿名身份验证,则不需要。
自从此以来webapps_authn.json.
文件生活在内webapps_private
仅由服务器帐户读取的文件夹,搜索者的凭据受到保护或登录服务器的其他用户。
基本:指定目录中的基本DN。基础DN是目录中的位置,其中应用程序开始搜索用户。例如:DC = MyLDAP,DC = MyBoston,DC = COM
.
Userfilter.:指定过滤器以查找用户的DN。MATLAB Web应用服务器用途Userfilter.
找到与输入的用户名匹配的用户的DN,表示为{username}在过滤器。如果未找到匹配项或找到多个匹配项,则身份验证失败。可以使用标准LDAP过滤器语法指定过滤器。例如:(& (objectClass =用户)(sAMAccountName = {username}))
.
checksslca.:检查LDAP服务器的SSL证书是否由可识别的证书颁发机构签署。将此属性设置为真的
检查有效的SSL证书并将其设置为错误的
放弃检查。如果设置为真的
,则需要指定值trustedSSLCA.如果设置为错误的
,用户名和密码仍在之间传输MATLAB Web应用服务器和LDAP服务器通过加密通道连接。但是,为了增加安全性,建议进行此检查。
trustedSSLCA:在Linux和苹果系统,指定签署站点证书的证书颁发机构(CA)颁发的根证书的路径。在Windows系统下,不需要指定路径。只要根证书在受信任的根证书颁发机构证书存储区,MATLAB Web应用服务器会自动找到它。
displayName:配置用户的身份显示方式MATLAB Web应用服务器通过指定用户LDAP条目的属性来实现。例如,将此属性设置为uid
显示用户ID。默认值是在身份验证过程中输入的用户名。
tokenExpirationMin:指定令牌的过期时间,单位为分钟。例如:60
.默认值为""
,这意味着令牌不会过期。
webapps_authn.json.
LDAP的文件{“版本”:“1.0.0”,“类型”:“ldap”,“authnconfig”:{host“:”myldap.myboston.com“,”port“:”“,”searcherdn“:”“,“SearcherPassword”:“”,“,”,“dc = myldap,dc = myboston,dc = com”,“userfilter”:“(&(objectclass = user)(samaccountname = {username}))”},“appconfig“:{”checksslca“:”false“,”trustedsslca“:”“,”displayname“:”uid“,”tokenexpirationmin“:”60“}}
OpenID Connect(OIDC)允许MATLAB Web应用服务器基于由第三方身份提供者(IDP)执行的认证验证最终用户的身份。要在服务器上使用OIDC身份验证,您需要注册与Microsoft等IDP®Azure.®广告或谷歌®身份平台。
要使用OIDC身份验证,请创建名为webapps_authn.json.
使用下面的JSON模式,并将其放在webapps_private
文件夹中。
{“版本”:“1.0.0”,“类型”:“oidc”,“authnconfig”:{“发布者”:“”,“ClientID”:“来自IDP的”<客户端ID>“,“cliencyecret”:“来自IDP的客户机秘密>”,“范围”:[“ ”]},“appconfig”:{“port”:“matlab web app服务器使用的“,”displayname“:”“,”,“tokenexpirationmin”:“”}}
版本:指定JSON模式的版本。的默认值R2020A是:1.0.0
.
类型:指定要使用的身份验证类型。将此值设置为oidc.
.
发行人:指定OIDC IDP发行版URI。例如,如果使用Google Identity平台:https://accounts.google.com/.well-known/openid-configuration.
.
clientId:指定客户ID您使用IDP注册凭据时获得的。例如,如果使用Google Identity平台:1234567890-xxxxxxxxxxxx.apps.googleUserContent.com
.
clielateecret:指定客户的秘密您使用IDP注册凭据时获得的。例如,如果使用Google Identity平台:_xxxxxxxxxxxxx_Xxxxxx_xX
.
自从此以来webapps_authn.json.
文件生活在内webapps_private
文件夹,只有服务器帐户可读,clientId和clielateecret被应用程序或其他登录服务器的用户保护。
范围:指定管理员想要的资源的标识符MATLAB Web应用服务器访问。例如,如果使用Google Identity平台:Openid Profile电子邮件
.
港口:指定使用的端口号MATLAB Web应用服务器用于OIDC身份验证。例如:3000.
.
displayName:配置用户的身份显示方式MATLAB Web应用服务器通过指定经过身份验证的用户对象的属性名,主页。例如,如果使用谷歌身份平台,给定的名称
显示用户的名称。默认是子
属性。
tokenExpirationMin:指定令牌的过期时间,单位为分钟。例如:60
.默认值为""
,这意味着令牌不会过期。
如果使用OIDC认证,需要注册MATLAB Web应用服务器作为A.应用国内流离失所者。
在注册过程中,需要为MATLAB Web App Server重定向URI。URI的格式为:https://
.例如:https://myboston.com:3000/oidc/callback.
.
webapps_authn.json.
OIDC使用文件谷歌身份平台{“版本”:“1.0.0”,“类型”:“oidc”,“authnconfig”:{“issuer”:“https://accounts.google.com/.well-known/openid-configuration”,“clientId": "1234567890-xxxxxxxxxxxx.apps.googleusercontent.com", "clientSecret": "_xxxxxxxxxxxxx_Xxxxxx_xX", "scope": ["openid profile email"] }, "appConfig": { "port": "3000", "displayName": "given_name", "tokenExpirationMin": "60" } }
设置身份验证后,如果您无法从浏览器登录,请尝试清除浏览器的缓存和cookie,或尝试其他浏览器。
JSON架构语法webapps_authn.json.
严格执行。模式语法中的错误可能导致服务器未启动,或尝试登录时拒绝访问服务器。