使用SDK接入URL风险检测-内容安全-阿里云-AI 安全护栏(AI Guardrails)-阿里云帮助中心

本文介绍如何在应用中集成 URL 风险检测 SDK，通过简单的 API 调用对 URL 进行风险检测，识别恶意链接、钓鱼网站等安全风险。

概述

URL 风险检测 SDK 基于阿里云内容安全服务，提供对 URL 链接的自动化风险识别能力。通过集成 SDK，您可以快速在应用中实现 URL 风险检测功能，有效识别钓鱼网站、恶意链接、欺诈页面等安全威胁。

前提条件

已开通内容安全服务。
已获取 AccessKey。建议使用 RAM 用户的 AccessKey 进行操作，避免使用主账号 AccessKey。
已安装对应语言的开发环境。

步骤一：获取 AccessKey

AccessKey 是调用阿里云 API 的身份凭证。建议通过环境变量传入 AccessKey ID 和 AccessKey Secret，避免硬编码。

重要

请勿将 AccessKey 硬编码在代码中，建议使用环境变量或密钥管理服务（KMS）进行安全管理。

步骤二：安装 SDK 依赖

根据您使用的编程语言，选择对应的安装方式。

步骤三：安装并接入 URL 风险检测服务

完成以下各语言 SDK 的安装和接入配置，即可在应用中调用 URL 风险检测服务。

Java SDK

Java SDK 用于在 Java 应用中接入 URL 风险检测服务。

在 pom.xml 的 dependencies 中添加以下依赖：

<dependency>
    <groupId>com.aliyun</groupId>
    <artifactId>green20220302</artifactId>
    <version>3.3.3</version>
</dependency>

初始化客户端并调用 URL 风险检测接口。示例代码如下：

import com.aliyun.green20220302.Client;
import com.aliyun.green20220302.models.*;
import com.aliyun.teaopenapi.models.*;

public class GreenDemo {
    public static void main(String[] args) throws Exception {
        Config config = new Config()
                .setAccessKeyId(System.getenv("ALIBABA_CLOUD_ACCESS_KEY_ID"))
                .setAccessKeySecret(System.getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET"));
        config.endpoint = "green-cip.cn-shanghai.aliyuncs.com";

        Client client = new Client(config);

        // 构建 URL 风险检测请求
        DetectUrlRiskRequest request = new DetectUrlRiskRequest()
                .setUrls(java.util.Arrays.asList("https://example.com/test"));

        // 发送请求并获取响应
        DetectUrlRiskResponse response = client.detectUrlRisk(request);
        System.out.println(response.getBody().getData());
    }
}

Python SDK

Python SDK 用于在 Python 应用中接入 URL 风险检测服务。

执行以下命令安装 pip 包：

pip install alibabacloud_green20220302==3.2.4

初始化客户端并调用 URL 风险检测接口。示例代码如下：

import os
from alibabacloud_green20220302.client import Client
from alibabacloud_green20220302 import models
from alibabacloud_tea_openapi.models import Config

config = Config(
    access_key_id=os.environ.get('ALIBABA_CLOUD_ACCESS_KEY_ID'),
    access_key_secret=os.environ.get('ALIBABA_CLOUD_ACCESS_KEY_SECRET'),
    endpoint='green-cip.cn-shanghai.aliyuncs.com'
)
client = Client(config)

# 构建 URL 风险检测请求
request = models.DetectUrlRiskRequest(
    urls=['https://example.com/test']
)

# 发送请求并获取响应
response = client.detect_url_risk(request)
print(response.body.data)

PHP SDK

PHP SDK 用于在 PHP 应用中接入 URL 风险检测服务。

执行以下命令引入相关依赖：

composer require alibabacloud/green-20220302 3.2.4

初始化客户端并调用 URL 风险检测接口。示例代码如下：

<?php
require __DIR__ . '/vendor/autoload.php';

use AlibabaCloud\SDK\Green\V20220302\Green;
use AlibabaCloud\SDK\Green\V20220302\Models\DetectUrlRiskRequest;
use AlibabaCloud\Tea\Utils\Utils;

$config = new AlibabaCloud\Tea\OpenApi\Models\Config();
$config->accessKeyId = getenv('ALIBABA_CLOUD_ACCESS_KEY_ID');
$config->accessKeySecret = getenv('ALIBABA_CLOUD_ACCESS_KEY_SECRET');
$config->endpoint = 'green-cip.cn-shanghai.aliyuncs.com';

$client = new Green($config);

// 构建 URL 风险检测请求
$request = new DetectUrlRiskRequest();
$request->urls = ['https://example.com/test'];

// 发送请求并获取响应
$response = $client->detectUrlRisk($request);
print_r($response->body->data);

Go SDK

Go SDK 用于在 Go 应用中接入 URL 风险检测服务。

执行以下命令引入相关依赖：

go get github.com/alibabacloud-go/green-20220302/v3

初始化客户端并调用 URL 风险检测接口。示例代码如下：

package main

import (
    "fmt"
    "os"

    green "github.com/alibabacloud-go/green-20220302/v3/client"
    "github.com/alibabacloud-go/tea/tea"
)

func main() {
    config := &openapi.Config{
        AccessKeyId:     tea.String(os.Getenv("ALIBABA_CLOUD_ACCESS_KEY_ID")),
        AccessKeySecret: tea.String(os.Getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET")),
        Endpoint:        tea.String("green-cip.cn-shanghai.aliyuncs.com"),
    }

    client, _ := green.NewClient(config)

    // 构建 URL 风险检测请求
    request := &green.DetectUrlRiskRequest{
        Urls: []*string{tea.String("https://example.com/test")},
    }

    // 发送请求并获取响应
    response, _ := client.DetectUrlRisk(request)
    fmt.Println(response.Body.Data)
}

Node.js SDK

Node.js SDK 用于在 Node.js 应用中接入 URL 风险检测服务。

执行以下命令引入相关依赖：

npm install @alicloud/green20220302@3.2.4

初始化客户端并调用 URL 风险检测接口。示例代码如下：

const Green20220302 = require('@alicloud/green20220302');
const OpenApi = require('@alicloud/openapi-client');

const config = new OpenApi.Config({
  accessKeyId: process.env.ALIBABA_CLOUD_ACCESS_KEY_ID,
  accessKeySecret: process.env.ALIBABA_CLOUD_ACCESS_KEY_SECRET,
  endpoint: 'green-cip.cn-shanghai.aliyuncs.com',
});

const client = new Green20220302.default(config);

async function main() {
  // 构建 URL 风险检测请求
  const request = new Green20220302.DetectUrlRiskRequest({
    urls: ['https://example.com/test'],
  });

  // 发送请求并获取响应
  const response = await client.detectUrlRisk(request);
  console.log(response.body.data);
}

main();

C# SDK

C# SDK 用于在 .NET 应用中接入 URL 风险检测服务。

执行以下命令引入相关依赖：

dotnet add package AlibabaCloud.SDK.Green20220302 --version 3.2.4

初始化客户端并调用 URL 风险检测接口。示例代码如下：

using System;
using System.Threading.Tasks;
using AlibabaCloud.SDK.Green20220302;
using AlibabaCloud.SDK.Green20220302.Models;
using AlibabaCloud.OpenApi.Models;

namespace GreenDemo
{
    class Program
    {
        static async Task Main(string[] args)
        {
            var config = new Config
            {
                AccessKeyId = Environment.GetEnvironmentVariable("ALIBABA_CLOUD_ACCESS_KEY_ID"),
                AccessKeySecret = Environment.GetEnvironmentVariable("ALIBABA_CLOUD_ACCESS_KEY_SECRET"),
                Endpoint = "green-cip.cn-shanghai.aliyuncs.com"
            };

            var client = new Client(config);

            // 构建 URL 风险检测请求
            var request = new DetectUrlRiskRequest
            {
                Urls = new System.Collections.Generic.List<string> { "https://example.com/test" }
            };

            // 发送请求并获取响应
            var response = await client.DetectUrlRiskAsync(request);
            Console.WriteLine(response.Body.Data);
        }
    }
}

后续步骤

完成 SDK 接入后，您可以参考以下文档进一步了解 URL 风险检测的使用：