程序包 ohos.security

类 NetworkSecurityPolicy

java.lang.Object

ohos.security.NetworkSecurityPolicy

public class NetworkSecurityPolicy
extends Object

Provides methods for querying network security policies. For example, you can call the isPlaintextAccessAllowed() method in this class to check whether plaintext is allowed for accessing a process.

An application can declare its network security settings in a security configuration file without modifying the code.

Calling methods in this class has the following advantages:

• Secure: It determines whether to disable plaintext-based access to a specified target to prevent an application from accidentally using plaintext.
• Convenient: An XML configuration file is used to set whether an application can access a specified domain using plaintext.

从以下版本开始:

3

SystemCapability

SystemCapability.Security.NetworkSecurityPolicy

方法概要

限定符和类型	方法	说明
static NetworkSecurityPolicy	getInstance()	Obtains the NetworkSecurityPolicy instance for this process.
boolean	isPlaintextAccessAllowed()	Checks whether plaintext is allowed for all network communications with this process.
boolean	isPlaintextAccessAllowed(String hostname)	Checks whether plaintext is allowed for the communication between this process and a specified hostname.

从类继承的方法 java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

方法详细资料

getInstance

public static NetworkSecurityPolicy getInstance()

Obtains the NetworkSecurityPolicy instance for this process.

You can obtain the NetworkSecurityPolicy instance in singleton pattern, but cannot create such an instance using the new method.

返回:

Returns the NetworkSecurityPolicy instance for this process.

从以下版本开始:

3

isPlaintextAccessAllowed

public boolean isPlaintextAccessAllowed()

Checks whether plaintext is allowed for all network communications with this process.

If plaintext is not allowed, the platform's components (such as HTTP and FTP stacks) will refuse plaintext HTTP requests from this process.

Theoretically, a network security policy is needed whenever possible. However, not all components support the network security policy. An example is the java.net.Socket API, which is unable to determine whether the network traffic is plaintext. Generally, most network traffic from applications is handled by higher-level network stacks or components that support the network security policy.

返回:

Returns true if plaintext is allowed for all network communications with this process; returns false otherwise.

从以下版本开始:

3

isPlaintextAccessAllowed

public boolean isPlaintextAccessAllowed(String hostname)

Checks whether plaintext is allowed for the communication between this process and a specified hostname.

参数:

hostname - Indicates the specified hostname.

返回:

Returns true if plaintext is allowed for the communication between this process and the specified hostname; returns false otherwise.

从以下版本开始:

3