The Security Information API offers functionalities for managing security information.

Required Header

#include <wifi-manager.h>

Overview

The Security Information API provides functions for managing the Security information. You can manage the Security information using the functions.

Related Features

This API is related with the following features:

http://tizen.org/feature/network.wifi

It is recommended to design applications with regard to features, for reliability.

You can check if a device supports the related features for this API by using System Information, and control your application's actions accordingly.

To ensure your application is only running on the device with specific features, please define the features in your manifest file using the manifest editor in the SDK.

More details on featuring your application can be found from Feature Element.

Functions
int	wifi_manager_ap_get_security_type (wifi_manager_ap_h ap, wifi_manager_security_type_e *type)
	Gets the Wi-Fi security mode.
int	wifi_manager_ap_is_security_type_supported (wifi_manager_ap_h ap, wifi_manager_security_type_e type, bool *supported)
	Checks whether a given security type is available in a given AP..
int	wifi_manager_ap_set_security_type (wifi_manager_ap_h ap, wifi_manager_security_type_e type)
	Sets the Wi-Fi security mode.
int	wifi_manager_ap_get_encryption_type (wifi_manager_ap_h ap, wifi_manager_encryption_type_e *type)
	Gets the Wi-Fi encryption type.
int	wifi_manager_ap_set_encryption_type (wifi_manager_ap_h ap, wifi_manager_encryption_type_e type)
	Sets the Wi-Fi encryption type.
int	wifi_manager_ap_is_passphrase_required (wifi_manager_ap_h ap, bool *required)
	Checks whether the passphrase is required or not.
int	wifi_manager_ap_set_passphrase (wifi_manager_ap_h ap, const char *passphrase)
	sets the passphrase for a Wi-Fi access point
int	wifi_manager_ap_is_wps_supported (wifi_manager_ap_h ap, bool *supported)
	Checks whether the WPS(Wi-Fi Protected Setup) is supported or not.
int	wifi_manager_ap_is_pmf_required (wifi_manager_ap_h ap, bool *required)
	Checks whether Protected Management Frame is required.

Enumeration Type Documentation

enum wifi_manager_encryption_type_e

Enumeration for Wi-Fi encryption type.

The following encryption modes are used in infrastructure and ad-hoc mode.

Since :: 3.0

Enumerator:

WIFI_MANAGER_ENCRYPTION_TYPE_NONE	Encryption disabled
WIFI_MANAGER_ENCRYPTION_TYPE_WEP	WEP
WIFI_MANAGER_ENCRYPTION_TYPE_TKIP	TKIP
WIFI_MANAGER_ENCRYPTION_TYPE_AES	AES
WIFI_MANAGER_ENCRYPTION_TYPE_TKIP_AES_MIXED	TKIP and AES are both supported

enum wifi_manager_security_type_e

Enumeration for Wi-Fi security type.

The following security modes are used in infrastructure and ad-hoc mode. For now all EAP security mechanisms are provided only in infrastructure mode.

Since :: 3.0

Enumerator:

WIFI_MANAGER_SECURITY_TYPE_NONE	Security disabled
WIFI_MANAGER_SECURITY_TYPE_WEP	WEP
WIFI_MANAGER_SECURITY_TYPE_WPA_PSK	WPA-PSK
WIFI_MANAGER_SECURITY_TYPE_WPA2_PSK	WPA2-PSK
WIFI_MANAGER_SECURITY_TYPE_EAP	EAP
WIFI_MANAGER_SECURITY_TYPE_WPA_FT_PSK	FT-PSK (Since 5.0)
WIFI_MANAGER_SECURITY_TYPE_SAE	SAE (Since 5.5)
WIFI_MANAGER_SECURITY_TYPE_OWE	OWE (Since 5.5)
WIFI_MANAGER_SECURITY_TYPE_DPP	DPP (Since 5.5)
WIFI_MANAGER_SECURITY_TYPE_FT_SAE	FT-SAE (Since 10.0)

Function Documentation

int wifi_manager_ap_get_encryption_type	(	wifi_manager_ap_h	ap,
		wifi_manager_encryption_type_e *	type
	)

Gets the Wi-Fi encryption type.

This function retrieves the Wi-Fi encryption type for the access point. The encryption type determines how data transmitted over the Wi-Fi network is protected from unauthorized access.

Since :: 3.0

Parameters:

[in]	ap	The access point handle
[out]	type	The type of Wi-Fi encryption

Returns:: 0 on success, otherwise negative error value

Return values:

WIFI_MANAGER_ERROR_NONE	Successful
WIFI_MANAGER_ERROR_NOT_INITIALIZED	Not initialized
WIFI_MANAGER_ERROR_INVALID_PARAMETER	Invalid parameter
WIFI_MANAGER_ERROR_OPERATION_FAILED	Operation failed
WIFI_MANAGER_ERROR_NOT_SUPPORTED	Not supported

int wifi_manager_ap_get_security_type	(	wifi_manager_ap_h	ap,
		wifi_manager_security_type_e *	type
	)

Gets the Wi-Fi security mode.

This function retrieves the Wi-Fi security mode for the access point. The security mode determines the level of protection provided to the Wi-Fi network against unauthorized access and attacks.

Since :: 3.0

Parameters:

[in]	ap	The access point handle
[out]	type	The type of Wi-Fi security

Returns:: 0 on success, otherwise negative error value

Return values:

WIFI_MANAGER_ERROR_NONE	Successful
WIFI_MANAGER_ERROR_NOT_INITIALIZED	Not initialized
WIFI_MANAGER_ERROR_INVALID_PARAMETER	Invalid parameter
WIFI_MANAGER_ERROR_OPERATION_FAILED	Operation failed
WIFI_MANAGER_ERROR_NOT_SUPPORTED	Not supported

int wifi_manager_ap_is_passphrase_required	(	wifi_manager_ap_h	ap,
		bool *	required
	)

Checks whether the passphrase is required or not.

This function checks whether a passphrase is required for the access point. A passphrase is necessary to authenticate and establish a secure connection with the access point.

Since :: 3.0

Remarks:: This function is not valid if security type is WIFI_MANAGER_SECURITY_TYPE_EAP.

Parameters:

[in]	ap	The access point handle
[out]	required	`true` if passphrase is required, `false` if passphrase is not required.

Returns:: 0 on success, otherwise negative error value

Return values:

WIFI_MANAGER_ERROR_NONE	Successful
WIFI_MANAGER_ERROR_NOT_INITIALIZED	Not initialized
WIFI_MANAGER_ERROR_INVALID_PARAMETER	Invalid parameter
WIFI_MANAGER_ERROR_OPERATION_FAILED	Operation failed
WIFI_MANAGER_ERROR_NOT_SUPPORTED	Not supported

int wifi_manager_ap_is_pmf_required	(	wifi_manager_ap_h	ap,
		bool *	required
	)

Checks whether Protected Management Frame is required.

This function checks whether PMF is required for the access point. PMF is a security feature that protects wireless networks from various types of attacks, such as deauthentication and disassociation attacks.

Since :: 7.0

Parameters:

[in]	ap	The access point handle
[out]	required	true when required and false when not required

Returns:: 0 on success, otherwise negative error value

Return values:

WIFI_MANAGER_ERROR_NONE	Successful
WIFI_MANAGER_ERROR_NOT_SUPPORTED	Not supported
WIFI_MANAGER_ERROR_INVALID_PARAMETER	Invalid parameter

int wifi_manager_ap_is_security_type_supported	(	wifi_manager_ap_h	ap,
		wifi_manager_security_type_e	type,
		bool *	supported
	)

Checks whether a given security type is available in a given AP..

An AP may support several types of security modes together. You can check all supported security modes with this function.

Since :: 7.0

Parameters:

[in]	ap	The access point handle
[in]	type	Wi-Fi security type
[out]	supported	true when enabled and false when disabled

Returns:: 0 on success, otherwise negative error value

Return values:

WIFI_MANAGER_ERROR_NONE	Successful
WIFI_MANAGER_ERROR_NOT_SUPPORTED	Not supported
WIFI_MANAGER_ERROR_INVALID_PARAMETER	Invalid parameter

int wifi_manager_ap_is_wps_supported	(	wifi_manager_ap_h	ap,
		bool *	supported
	)

Checks whether the WPS(Wi-Fi Protected Setup) is supported or not.

This function checks whether WPS is supported by the access point. WPS is a standard that simplifies the process of setting up secure Wi-Fi connections by allowing devices to connect to each other without entering passwords manually.

Since :: 3.0

Parameters:

[in]	ap	The access point handle
[out]	supported	`true` if WPS is supported, otherwise `false` is WPS is not supported.

Returns:: 0 on success, otherwise negative error value

Return values:

WIFI_MANAGER_ERROR_NONE	Successful
WIFI_MANAGER_ERROR_NOT_INITIALIZED	Not initialized
WIFI_MANAGER_ERROR_INVALID_PARAMETER	Invalid parameter
WIFI_MANAGER_ERROR_OPERATION_FAILED	Operation failed
WIFI_MANAGER_ERROR_NOT_SUPPORTED	Not supported

See also:: wifi_manager_connect_by_wps_pbc(); wifi_manager_connect_by_wps_pin()

int wifi_manager_ap_set_encryption_type	(	wifi_manager_ap_h	ap,
		wifi_manager_encryption_type_e	type
	)

Sets the Wi-Fi encryption type.

This function sets the Wi-Fi encryption type for the access point. The encryption type determines how data transmitted over the Wi-Fi network is protected from unauthorized access.

Since :: 3.0

Parameters:

[in]	ap	The access point handle
[in]	type	The type of Wi-Fi encryption

Returns:: 0 on success, otherwise negative error value

Return values:

WIFI_MANAGER_ERROR_NONE	Successful
WIFI_MANAGER_ERROR_NOT_INITIALIZED	Not initialized
WIFI_MANAGER_ERROR_INVALID_PARAMETER	Invalid parameter
WIFI_MANAGER_ERROR_OPERATION_FAILED	Operation failed
WIFI_MANAGER_ERROR_NOT_SUPPORTED	Not supported

int wifi_manager_ap_set_passphrase	(	wifi_manager_ap_h	ap,
		const char *	passphrase
	)

sets the passphrase for a Wi-Fi access point

This function sets the passphrase for a Wi-Fi access point. The passphrase is used to authenticate and establish a secure connection with the access point.

Since :: 3.0

Parameters:

[in]	ap	The access point handle
[in]	passphrase	The passphrase of access point

Returns:: 0 on success, otherwise negative error value

Return values:

WIFI_MANAGER_ERROR_NONE	Successful
WIFI_MANAGER_ERROR_NOT_INITIALIZED	Not initialized
WIFI_MANAGER_ERROR_INVALID_PARAMETER	Invalid parameter
WIFI_MANAGER_ERROR_OPERATION_FAILED	Operation failed
WIFI_MANAGER_ERROR_NOT_SUPPORTED	Not supported

int wifi_manager_ap_set_security_type	(	wifi_manager_ap_h	ap,
		wifi_manager_security_type_e	type
	)

Sets the Wi-Fi security mode.

This function sets the Wi-Fi security mode for the access point. The security mode determines the level of protection provided to the Wi-Fi network against unauthorized access and attacks.

Since :: 3.0

Parameters:

[in]	ap	The access point handle
[in]	type	The type of Wi-Fi security

Returns:: 0 on success, otherwise negative error value

Return values:

WIFI_MANAGER_ERROR_NONE	Successful
WIFI_MANAGER_ERROR_NOT_INITIALIZED	Not initialized
WIFI_MANAGER_ERROR_INVALID_PARAMETER	Invalid parameter
WIFI_MANAGER_ERROR_OPERATION_FAILED	Operation failed
WIFI_MANAGER_ERROR_NOT_SUPPORTED	Not supported

Required Header

Overview

Related Features

Functions

Enumeration Type Documentation

Function Documentation