获取用户拥有的及与用户共享的资源

GET

此 API 用于检索与用户关联的完整资源列表。响应结果包含用户直接拥有的资源,以及其他所有者与用户共享的资源。

请求 URL

https://<PAM360 服务器的主机名或 IP 地址>:<端口号>/restapi/json/v1/resources

请求头参数

{
    "AUTHTOKEN":"<<由PAM360生成的认证令牌>>",
    "orgName"  :"<<组织显示名称>>"
}

参数 描述

AUTHTOKEN

用于授权 API 请求的用户身份验证令牌。
类型:字符串
必填:是

默认值:不适用

orgName

PAM360 中可用的组织名称。
类型:字符串
必填:否

默认值: 用户所属的组织

查询参数

INPUT_DATA =
{
"operation" : {
    "Details" : {
    "VIEWTYPE"   :"ALLMYPASSWORD",
    "STARTINDEX" :0,
	"LIMIT"      :10,
    "SEARCHTYPE" :"RESOURCE",
    "SEARCHVALUE":"CNS-E01",
    "SEARCHCOLUMN":"RESOURCENAME"
    }
}
}

参数 描述

VIEWTYPE

指定要检索的密码类别。
类型:字符串
必填:否

默认值:ALLMYPASSWORD
允许的值:ALLMYPASSWORD 、FAVOURITEPASSWORD、RECENTLYACCESSEDPASSWORD、LINUXSSHPASSWORD、WINDOWSRDPPASSWORD

STARTINDEX

指示结果集的起点或索引。
类型:整数
必填:否

默认值:0

LIMIT

指定要检索的记录最大数量。
类型:整数
必填:否

默认值: 将获取所有 资源。

SEARCHTYPE

定义搜索应在资源还是账户上进行。
类型:字符串
必填:否

默认值:不适用
允许的值:RESOURCE 、ACCOUNT

SEARCHVALUE

用于搜索的关键词。
类型:字符串
必填:否

默认值:不适用

SEARCHCOLUMN

指定应应用搜索的列。
类型:字符串
必填:否

默认值:不适用
允许的值:ALL 、RESOURCE_TYPE、RESOURCENAME、RESOURCEDESC、IPADDRESS、LOGINNAME、OPERATINGSYSTEM、DEPARTMENT、LOCATION、DOMAINNAME、RESOURCEURL、COLUMN_CHAR[0-9]*、COLUMN_LONG[0-9]*、 COLUMN_SCHAR[0-9]*, COLUMN_DATE[0-9]*, COLUMN_FILE[0-9]*

请求示例

cURL Python PowerShell
curl GET -G -H "Content-Type: application/x-www-form-urlencoded" -H "AUTHTOKEN:<由PAM360生成的认证令牌>" https://<PAM360服务器的主机名或IP地址>:<端口>/restapi/json/v1/resources --data-urlencode "INPUT_DATA={\"operation\":{\"Details\":{\"VIEWTYPE\":\"ALLMYPASSWORD\",\"STARTINDEX\":\"1\",\"LIMIT\":\"10\",\"SEARCHTYPE\":\"RESOURCE\",\"SEARCHVALUE\":\"CNS-E01\",\"SEARCHCOLUMN\":\"ALL\"}}}"
#!/usr/bin/env python3
 
import requests
import urllib3
import json
 
urllib3.disable_warnings(urllib3.exceptions.InsecureRequestWarning)
 
def main():
    config = {
        "auth_token":"<<由PAM360生成的认证令牌>>",
        "host_name": "https://<PAM360服务器的主机名或IP地址>:<端口号>"
    }
 
    session = requests.Session()
    session.verify = True   # 仅在使用自签名证书时设为 False
 
    try:
        url = f"{config['host_name']}/restapi/json/v1/resources"
 
        headers = {
            "AUTHTOKEN": config["auth_token"]
        }
 
        input_data = {
            "operation": {
                "Details": {
                    "VIEWTYPE":"ALLMYPASSWORD",
                    "STARTINDEX":"1",
                    "LIMIT":"10",
                   "SEARCHTYPE":"RESOURCE",
                    "SEARCHVALUE":"CNS-E01",
                    "SEARCHCOLUMN":"ALL"
                }
            }
        }
 
        # INPUT_DATA 必须是 JSON 字符串
        params = {
            "INPUT_DATA": json.dumps(input_data)
        }
 
        response = session.get(
            url,
            headers=headers,
            params=params,
            timeout=10
        )
 
        print("状态码:", response.status_code)
        print("响应:")
        print(response.text)
 
    except Exception as e:
        print("错误:", e)
 
    finally:
        session.close()


if __name__ == "__main__":
    main()
$Url= "https://<PAM360服务器的主机名或IP地址>:<端口>/restapi/json/v1/resources"

$Body = @{
    "INPUT_DATA" = '{ "operation": { "Details": {
        "VIEWTYPE":"ALLMYPASSWORD",
		"STARTINDEX":1,
        "LIMIT":10,
        "SEARCHTYPE":"RESOURCE",
        "SEARCHVALUE":"CNS-E01",
        "SEARCHCOLUMN":"RESOURCENAME"
    } } }'
}

$Header = @{
    "AUTHTOKEN"="<由PAM360生成的认证令牌>"
}

$response = Invoke-WebRequest -Method Get -Headers $Header -Uri $Url -Body $Body
$response.Content

响应示例

{
  "operation": {
    "result": {
      "message":"资源获取成功",
      "status":"Success"
    },
    "Details": [
      {
        "RESOURCE DESCRIPTION":"",
        "RESOURCE TYPE":"Windows",
        "RESOURCE ID":"1",
        "RESOURCE NAME":"CNS-E01",
       "NOOFACCOUNTS":"2",
        "DNS NAME":""
      }
    ],
    "name":"GET RESOURCES",
    "totalRows":1
  }
}



Top