libpsl 开源项目教程

周屹隽

于 2024-09-28 07:23:15 发布

阅读量756

点赞数 16

本文链接：https://blog.csdn.net/gitblog_00583/article/details/142607139

版权

libpsl 开源项目教程

libpsl C library for the Public Suffix List 项目地址: https://gitcode.com/gh_mirrors/li/libpsl

1. 项目介绍

libpsl 是一个用C语言编写的库，用于处理公共后缀列表（Public Suffix List, PSL）。公共后缀列表是一个包含顶级域名（TLD）后缀的集合，包括全球顶级域名（gTLD）、国家顶级域名（ccTLD）以及品牌顶级域名（如 .apple 和 .google）。浏览器、Web客户端和其他用户代理可以使用公共后缀列表来避免隐私泄露的“超级cookie”和“超级域”证书，并在用户界面中突出显示域名的各个部分。

libpsl 具有以下特点：

内置PSL数据，访问速度快。
支持从文件加载PSL数据。
检查给定域名是否为“公共后缀”。
提供即时cookie域名验证。
查找给定域名的最长公共部分和最短私有部分。
支持国际化域名（UTF-8和IDNA2008 Punycode）。
线程安全。
支持IDNA2008 UTS#46（如果安装了libicu）。

2. 项目快速启动

2.1 安装依赖

在开始之前，确保系统中安装了以下依赖：

Python 2.7+
基本的C开发工具（编译器、链接器、make）
autoconf, autoconf-archive, autopoint, automake, autotools, libtool, gettext, pkg-config
可选：libidn2, libicu 或 libidn

2.2 下载并编译项目

# 克隆项目
git clone --recursive https://github.com/rockdaboot/libpsl.git
cd libpsl

# 使用GNU autotools编译
./autogen.sh
./configure
make
make check

# 安装
sudo make install

2.3 使用示例

以下是一个简单的示例代码，展示了如何使用libpsl库来检查一个域名是否为公共后缀，并验证cookie域名是否可接受。

#include <stdio.h>
#include <libpsl.h>

int main(int argc, char **argv) {
    const char *domain = "www.example.com";
    const char *cookie_domain = ".com";
    const psl_ctx_t *psl = psl_builtin();

    int is_public = psl_is_public_suffix(psl, domain);
    printf("%s %s a public suffix\n", domain, is_public ? "is" : "is not");

    int is_acceptable = psl_is_cookie_domain_acceptable(psl, domain, cookie_domain);
    printf("cookie domain '%s' %s acceptable for domain '%s'\n", cookie_domain, is_acceptable ? "is" : "is not", domain);

    return 0;
}