SignInToPortal

摘要

允许您登录门户。

说明

必须登录门户才可以共享内容或运行即用型工具。 门户可以是 ArcGIS Enterprise 门户或 ArcGIS Online 门户。

要添加门户连接，请单击功能区中的工程选项卡，然后单击门户页面。 有关详细信息，请参阅通过 ArcGIS Pro 管理门户连接。

SignInToPortal 会将门户 URL 添加到门户连接（如有必要），请登录并将门户设置为活动状态。 如果在 Python 窗口中执行该操作，则系统会将门户设置为活动门户，如果不在 Python 窗口中执行，请将其添加到门户连接，以用于将来的 ArcGIS Pro 或独立 Python 会话。 但是，如果在独立 Python 会话中执行该操作，则系统将只能在 Python 会话活动期间使用门户信息。

当以门户用户身份登录时或当根据以下受支持门户身份验证配置登录帐户时，可能需要不同的参数：

• 如果门户使用内置安全性，提供用户名和密码。
• 如果门户使用公钥基础设施 (PKI) 身份验证，则提供 PKCS12 格式的证书文件（.pfx 或 .p12）和证书密码。

  还可以提供 PEM 格式的证书和密钥文件。 证书和密钥的文件扩展名均为 .pem。

• 如果门户使用集成的 Windows 身份验证 (IWA)，保持用户名和密码参数为空。 不支持提供 Windows 用户名和密码。

不支持在 Linux 计算机上登录使用 IWA 或 PKI 的门户。

语法

SignInToPortal (portal_url, {username}, {password}, {cert_file}, {key_file})

参数	说明	数据类型
portal_url	The URL of the portal to sign in to.	String
username	The user name of the user signing in to the portal. If the portal uses IWA, leave this parameter empty. You can only sign in as the current Windows user.	String
password	The password of the user signing in to the portal. If the portal uses PKI authentication, the password to the PKCS12 certificate file. If the portal uses IWA, leave this parameter empty.	String
cert_file	If the portal uses PKI authentication, the path to the PKCS12 formatted certificate file (.pfx or .p12) or the PEM formatted certificate file (.pem).	String
key_file	If the portal uses PKI authentication, the path to the PEM formatted key file (.pem).	String

返回值

数据类型	说明
Dictionary	expires、referer 和 token 的键值对的字典。

代码示例

SignInToPortal 示例 1

登录使用内置安全性的门户。

import arcpy

arcpy.SignInToPortal("https://webadaptorhost.domain.com/webadaptorname", 
                     'username', 'password')

SignInToPortal 示例 2

使用 PKCS12 格式的证书文件（.pfx 或 .p12）和密码登录使用公钥基础设施（PKI 身份验证）的门户。

import arcpy

arcpy.SignInToPortal("https://webadaptorhost.domain.com/webadaptorname", 
                     cert_file="C:\\path\\to\\mycert.pfx", 
                     password="cert.password")

SignInToPortal 示例 3

使用 PEM 格式的证书文件 (.pem) 和密钥文件 (.pem) 登录使用公钥基础设施（PKI 身份验证）的门户。

import arcpy

arcpy.SignInToPortal("https://webadaptorhost.domain.com/webadaptorname", 
                     cert_file="C:\\path\\to\\mycert.pem", 
                     key_file="C:\\path\\to\\mykey.pem")

SignInToPortal 示例 4

不输入用户名和密码来登录使用集成的 Windows 身份验证 (IWA) 的门户。

import arcpy

arcpy.SignInToPortal("https://webadaptorhost.domain.com/webadaptorname")