界: API Abuse

API 是调用方和被调用方之间的约定。最常见的 API 滥用是由于调用方未能遵守此约定的终止导致的。例如，如果某个程序在调用 chroot() 后未能调用 chdir()，则违反了用于指定如何安全地更改活动根目录的约定。库滥用的另一个典型示例是期望被调用方向调用方返回可信的 DNS 信息。在这种情况下，调用方通过对被调用方行为做出某种假设（返回值可用于身份验证目的）滥用其 API。另一方也可能违反调用方-被调用方约定。例如，如果编码器子类化 SecureRandom 并返回一个非随机值，则将违反此约定。

Often Misused: File System

Abstract

将一个长度不合适的输出缓冲区传递到一个 path manipulation 函数，会导致 buffer overflow。

Explanation

Windows 提供了大量的实用程序函数来处理包含文件名的缓冲区。在大多数情况下，结果会返回到一个作为输入传入的缓冲区中。（通常文件名会进行适当的修改。）大多数函数需要缓冲区至少为 MAX_PATH 字节的长度，但是您应该逐一检查每一个函数的文档。如果缓冲区大小不足以存储处理的结果，那么就会发生 buffer overflow。

示例：


char *createOutputDirectory(char *name) {
	char outputDirectoryName[128];
	if (getCurrentDirectory(128, outputDirectoryName) == 0) {
		return null;
	}
	if (!PathAppend(outputDirectoryName, "output")) {
		return null;
	}
	if (!PathAppend(outputDirectoryName, name)) {
		return null;
	}
	if (SHCreateDirectoryEx(NULL, outputDirectoryName, NULL)
        != ERROR_SUCCESS) {
		return null;
	}
	return StrDup(outputDirectoryName);
}

在这个例子中，函数在当前目录中创建了名为 "output\<name>" 的目录，并且返回了一个同样名称的堆分配副本。对于大多数当前目录和名称参数的值来说，该函数都能够正常工作。但是，如果 name 参数特别长，那么第二个对 PathAppend() 的调用可能会溢出 outputDirectoryName 缓冲区，因为该缓冲区比 MAX_PATH 字节小。

References

[1] Standards Mapping - CIS Azure Kubernetes Service Benchmark 1

[2] Standards Mapping - CIS Microsoft Azure Foundations Benchmark partial

[3] Standards Mapping - CIS Amazon Elastic Kubernetes Service Benchmark 1

[4] Standards Mapping - CIS Amazon Web Services Foundations Benchmark 2

[5] Standards Mapping - CIS Google Kubernetes Engine Benchmark integrity

[6] Standards Mapping - Common Weakness Enumeration CWE ID 249, CWE ID 560

[7] Standards Mapping - General Data Protection Regulation (GDPR) Access Violation

[8] Standards Mapping - OWASP Top 10 2004 A5 Buffer Overflow

[9] Standards Mapping - Payment Card Industry Data Security Standard Version 1.1 Requirement 6.5.5

[10] Standards Mapping - Payment Card Industry Data Security Standard Version 1.2 Requirement 6.3.1.1

[11] Standards Mapping - Payment Card Industry Data Security Standard Version 2.0 Requirement 6.5.2

[12] Standards Mapping - Payment Card Industry Data Security Standard Version 3.0 Requirement 6.5.2

[13] Standards Mapping - Payment Card Industry Data Security Standard Version 3.2 Requirement 6.5.2

[14] Standards Mapping - Payment Card Industry Data Security Standard Version 3.2.1 Requirement 6.5.2

[15] Standards Mapping - Payment Card Industry Data Security Standard Version 3.1 Requirement 6.5.2

[16] Standards Mapping - Payment Card Industry Data Security Standard Version 4.0 Requirement 6.2.4

[17] Standards Mapping - Payment Card Industry Software Security Framework 1.0 Control Objective 4.2 - Critical Asset Protection

[18] Standards Mapping - Payment Card Industry Software Security Framework 1.1 Control Objective 4.2 - Critical Asset Protection

[19] Standards Mapping - Payment Card Industry Software Security Framework 1.2 Control Objective 4.2 - Critical Asset Protection

[20] Standards Mapping - Security Technical Implementation Guide Version 3.1 APP3590.1 CAT I

[21] Standards Mapping - Security Technical Implementation Guide Version 3.4 APP3590.1 CAT I

[22] Standards Mapping - Security Technical Implementation Guide Version 3.5 APP3590.1 CAT I

[23] Standards Mapping - Security Technical Implementation Guide Version 3.6 APP3590.1 CAT I

[24] Standards Mapping - Security Technical Implementation Guide Version 3.7 APP3590.1 CAT I

[25] Standards Mapping - Security Technical Implementation Guide Version 3.9 APP3590.1 CAT I

[26] Standards Mapping - Security Technical Implementation Guide Version 3.10 APP3590.1 CAT I

desc.semantic.cpp.often_misused_file_system.windows

Abstract

由参数 umask() 指定的掩码常常很容易与 chmod() 的参数混淆。

Explanation

umask() man page 以错误的指令开始：

"umask sets the umask to mask & 0777"

尽管这种行为可以更好地遵从 chmod() 的用法，这种情况下，由用户提供的参数指定在特定文件上启用的位数，但事实上 umask() 的行为恰恰相反： umask() 将 umask 设为 ~mask & 0777。

umask() man page 接下来描述了 umask() 的正确使用方法：

“open() 使用 umask 为新建文件设置初始文件权限。具体而言，它会关闭 umask 从 mode 参数传递到 open(2) 的权限（例如，umask 的通用默认值 022 会导致以权限 0666 & ~022 = 0644 = rw-r--r-- 创建新文件，而在正常情况下，mode 应该为 0666）。”