Bảo mật

Chính sách bảo mật của tổ chức: 2FA, dải IP quản trị, thời lượng phiên, tự duyệt.

Endpoint

Method	Path	Tóm tắt	Quyền	Nhóm tốc độ	Tương tác
GET	/v1/security/policy	Chính sách bảo mật của tổ chức	tenant.manage	read	Scalar
PUT	/v1/security/policy	Đổi chính sách bảo mật	security.policy.write	write	Scalar

Chi tiết endpoint

GET /v1/security/policy

Chính sách bảo mật của tổ chức

Chưa ghi lần nào thì trả giá trị mặc định. Chỉ người dùng có quyền quản trị tổ chức; không dùng với khoá API hay OAuth.

Quyền: tenant.manage

• Nhóm tốc độ: read
• Phản hồi thành công 200: Chính sách. — SecurityPolicy, application/json
• Mã lỗi: chỉ các mã lỗi chung ở Tổng quan

curl

curl -sS -X GET "https://api.dongtien.pro/v1/security/policy" \
  -H "Authorization: Bearer $DT_API_KEY"

TypeScript

import { createClient } from "@dongtien/sdk";

const dt = createClient({ apiKey: process.env.DT_API_KEY! });

const { data } = await dt.GET("/v1/security/policy");

Python

import os

from dongtien import DongTien
from dongtien_api.api.bao_mat import get_security_policy

with DongTien(api_key=os.environ["DT_API_KEY"]) as dt:
    result = get_security_policy.sync(client=dt.client)

Mở trong tài liệu tương tác

PUT /v1/security/policy

Đổi chính sách bảo mật

Cần xác thực lại gần đây (step-up); không dùng với khoá API hay OAuth. Bật tự duyệt hoặc đổi hạn mức tự duyệt chỉ chủ sở hữu được làm.

Quyền: security.policy.write Cần xác thực lại gần đây

• Nhóm tốc độ: write
• Nội dung yêu cầu: SecurityPolicyPatch (application/json, bắt buộc)
• Phản hồi thành công 200: Chính sách sau khi đổi. — SecurityPolicy, application/json
• Mã lỗi riêng của endpoint: step_up_required, conflict

curl

curl -sS -X PUT "https://api.dongtien.pro/v1/security/policy" \
  -H "Authorization: Bearer $DT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "require_2fa": true,
  "require_2fa_grace_days": 7,
  "session_max_hours": 8
}'

TypeScript

import { createClient } from "@dongtien/sdk";

const dt = createClient({ apiKey: process.env.DT_API_KEY! });

const { data } = await dt.PUT("/v1/security/policy", {
  body: {
    "require_2fa": true,
    "require_2fa_grace_days": 7,
    "session_max_hours": 8
  },
});

Python

import os

from dongtien import DongTien
from dongtien_api.api.bao_mat import update_security_policy
from dongtien_api.models import SecurityPolicyPatch

with DongTien(api_key=os.environ["DT_API_KEY"]) as dt:
    result = update_security_policy.sync(
        client=dt.client,
        body=SecurityPolicyPatch.from_dict({
            "require_2fa": True,
            "require_2fa_grace_days": 7,
            "session_max_hours": 8,
        }),
    )

Mở trong tài liệu tương tác

Đối tượng

SecurityPolicy

Trường	Kiểu	Bắt buộc	Mô tả
admin_ip_allowlist	string[]	Có	Dải CIDR được phép thao tác quản trị; rỗng = mọi nơi.
new_location_alert	boolean	Có	—
require_2fa	boolean	Có	—
require_2fa_grace_days	integer	Có	—
self_approval	object	Có	—
self_approval.enabled	boolean	Có	—
self_approval.threshold_vnd	integer	Có	Hạn mức tự duyệt, VND (số nguyên).
session_max_hours	integer	Có	—

SecurityPolicyPatch

Trường	Kiểu	Bắt buộc	Mô tả
admin_ip_allowlist	string[]	Không	—
new_location_alert	boolean	Không	—
require_2fa	boolean	Không	—
require_2fa_grace_days	integer	Không	—
self_approval	object	Không	—
self_approval.enabled	boolean	Không	—
self_approval.threshold_vnd	integer	Không	—
session_max_hours	integer	Không	—