# Harmony安全管控(7.58)

| 组件名称 | 组件类型 | 组件版本 | 生效基线 |
| --- | --- | --- | --- |
| security_exemption_api | 协议组件 | 1.0.0 | 7.58.0 |

## 功能简介
提供安全功能豁免与恢复能力，支持截屏保护等安全策略的动态控制

### 更新日志
- 精简接口，仅保留 ISecurityExemptionApi 及其配套枚举，移除 EMM 相关接口与类型

## 示例代码
完整示例请查看 [SamplApp](https://github.com/larksuite/alchemy_app_demo/tree/main/alchemy_app_demo_harmony)

```ets
import { ISecurityExemptionApi, SecurityBizType, SecurityActionType } from '@ohos/security_exemption_api'

export class KARuntimeManager {
  private securityApi?: ISecurityExemptionApi;

public loadModule(runtime: TrimisContainerWrapperInterface) {
    this.securityApi = runtime.getSecurityExemptionApi();

// 请求截屏保护豁免
    const result = this.securityApi?.requestExemptionAction(
      SecurityBizType.SCREEN_CAPTURE_PROTECT,
      SecurityActionType.EXEMPT
    );
  }
}
```

## INTERFACE
### ISecurityExemptionApi
安全功能豁免接口

```ets
interface ISecurityExemptionApi {
  requestExemptionAction(securityBizType: SecurityBizType, actionType: SecurityActionType): SecurityActionResult // 请求安全功能豁免或恢复
}
```

#### 方法列表
#### `requestExemptionAction(securityBizType: SecurityBizType, actionType: SecurityActionType): SecurityActionResult`
请求安全功能豁免或恢复

| 参数名称 | 类型 | 必填 | 描述 |
| --- | --- | --- | --- |
| securityBizType | SecurityBizType | 是 | 安全功能 |
| actionType | SecurityActionType | 是 | 预期行为 |

**返回值**：执行结果

## ENUM
### SecurityBizType
安全功能

```ets
enum SecurityBizType {
  UNKNOWN,
  SCREEN_CAPTURE_PROTECT
}
```

#### 枚举成员
| 成员名 | 值 | 描述 |
| --- | --- | --- |
| UNKNOWN | 0 | 未知 |
| SCREEN_CAPTURE_PROTECT | 1 | 截屏保护 |

### SecurityActionType
行为类别

```ets
enum SecurityActionType {
  EXEMPT,
  RESUME
}
```

#### 枚举成员
| 成员名 | 值 | 描述 |
| --- | --- | --- |
| EXEMPT | 0 | 豁免 |
| RESUME | 1 | 恢复 |

### SecurityActionResult
执行结果

```ets
enum SecurityActionResult {
  SUCCESS,
  FAILED
}
```

#### 枚举成员
| 成员名 | 值 | 描述 |
| --- | --- | --- |
| SUCCESS | 0 | 成功 |
| FAILED | 1 | 失败 |