7 releases

new 0.3.4 Nov 24, 2024
0.3.3 Sep 26, 2024
0.3.2 May 6, 2024
0.2.0 Apr 25, 2024
0.1.0 Apr 25, 2024

#1147 in Web programming


Used in desec_cli

MIT license

65KB
1K SLoC

deSEC Client

Unofficial client library for the deSEC DNS API.

deSEC is a free DNS hosting service, designed with security in mind. Running on open-source software and supported by SSE, deSEC is free for everyone to use.

Supported API endpoints

Supported endpoints

  • Manage accounts

    • Obtain a Captcha
    • Register Account with optional domain creation
    • Log In (Retrieve API token using email & password)
    • Log Out (When client was created from credentials)
    • Retrieve account information
    • Modify account settings (only updating outreach_preference is supported by the API)
    • Password reset (Request for password reset & confirmation, but handling of approval via mail needs to be handled)
    • Password change
    • Change of email address
    • Delete account
  • Manage domains

    • Creating a domain
    • List domains
    • Retrieve a specific domain
    • Identifying the responsible domain for a DNS name
    • Exporting a domain as zonefile
    • Deleting a domain
  • Manage DNS records

    • Creating an RRset
    • Retrieving all RRsets in a Zone
    • Retrieving all RRsets in a Zone filtered by type
    • Retrieving all RRsets in a Zone filtered by subname
    • Retrieving a Specific RRset
    • Modifying an RRset
    • Deleting an RRset
  • Manage Tokens

    • Create a token
    • Modify a token
    • List all tokens
    • Retrieve a specific token
    • Delete a token
  • Manage Token Policies

    • Create a token policy (including default policy)
    • Modify a token policy
    • List all token policies
    • Delete a token policy

Currently not supported

  • Pagination when over 500 items exist
  • Manage DNS records
    • Bulk operations when modifying or deleting RRsets

License

See LICENSE-MIT for details.

Dependencies

~7–18MB
~253K SLoC