Early public release

Author: wolveix

Diff for: .github/workflows/build.yml

@@ -0,0 +1,29 @@
+name: Build
+
+on:
+  push:
+    branches: [ main, dev ]
+  pull_request:
+    branches: [ main, dev ]
+
+jobs:
+
+  build:
+    name: Build
+    runs-on: ubuntu-latest
+    steps:
+
+      - name: Set up Go 1.18
+        uses: actions/setup-go@v1
+        with:
+          go-version: 1.18
+        id: go
+
+      - name: Check out code into the Go module directory
+        uses: actions/checkout@v2
+
+      - name: Get dependencies
+        run: |
+          go get -v -t -d ./...
+      - name: Build
+        run: go build -v .

Diff for: README.md

@@ -1 +1,58 @@
-# directadmin-go
+# DirectAdmin Go SDK
+Interface with a DirectAdmin installation using Go.
+
+This library supports both the legacy/default DirectAdmin API, as well as their new modern API that's still in active development.
+
+**Note: This is in an experimental state. While it's being used in production, the library is very likely to change (especially in-line with DA's own changes). DA features are being added as needed on our end, but PRs are always welcome!**
+
+**If you wonder why something has been handled in an unusual way, it's most likely a workaround required by one of DA's many quirks.**
+
+## Login as Admin / Reseller / User
+To open a session as an admin/reseller/user, follow the following code block:
+
+```go
+package main
+
+import (
+	"encoding/json"
+	"time"
+	"github.com/levelzerotechnology/directadmin-go"
+)
+
+func main() {
+	api, err := directadmin.New("https://your.da.address:2222", 5*time.Second)
+	if err != nil {
+		panic(err)
+	}
+
+	userCtx, err := api.LoginAsUser("your_username", "some_password_or_key")
+	if err != nil {
+		panic(err)
+	}
+
+	usage, err := userCtx.GetMyUserUsage()
+	if err != nil {
+		panic(err)
+	}
+
+	userCtx.User.Usage = *usage
+}
+```
+
+From here, you can call user functions via `userCtx`.
+
+For example, if you wanted to print each of your databases to your terminal:
+```go
+dbs, err := userCtx.GetDatabases()
+if err != nil {
+	log.Fatalln(err)
+}
+
+for _, db := range dbs {
+	fmt.Println(db.Name)
+}
+```
+
+## License
+
+BSD licensed. See the [LICENSE](LICENSE) file for details.

Diff for: admin.go

@@ -0,0 +1,74 @@
+package directadmin
+
+import "net/http"
+
+// Admin inherits Reseller which inherits User
+type Admin struct {
+	Reseller
+}
+
+type AdminContext struct {
+	ResellerContext
+}
+
+type convertAccount struct {
+	Account string `json:"account,omitempty"`
+	Creator string `json:"creator,omitempty"`
+}
+
+func (c *AdminContext) ConvertResellerToUser(username string, reseller string) error {
+	if _, err := c.api.makeRequestN(http.MethodPost, "convert-reseller-to-user", c.credentials, convertAccount{Account: username, Creator: reseller}, nil); err != nil {
+		return err
+	}
+
+	return nil
+}
+
+func (c *AdminContext) ConvertUserToReseller(username string) error {
+	if _, err := c.api.makeRequestN(http.MethodPost, "convert-user-to-reseller", c.credentials, convertAccount{Account: username}, nil); err != nil {
+		return err
+	}
+
+	return nil
+}
+
+// GetAllUsers (admin) returns an array of all users
+func (c *AdminContext) GetAllUsers() ([]string, error) {
+	var users []string
+
+	if _, err := c.api.makeRequest(http.MethodGet, "API_SHOW_ALL_USERS", c.credentials, nil, &users); err != nil {
+		return nil, err
+	}
+
+	return users, nil
+}
+
+// GetResellers (admin) returns an array of all resellers
+func (c *AdminContext) GetResellers() ([]string, error) {
+	var users []string
+
+	if _, err := c.api.makeRequest(http.MethodGet, "API_SHOW_RESELLERS", c.credentials, nil, &users); err != nil {
+		return nil, err
+	}
+
+	return users, nil
+}
+
+// TODO: finish implementation
+func (c *AdminContext) GetResellersWithUsage() ([]string, error) {
+	var users []string
+
+	if _, err := c.api.makeRequest(http.MethodGet, "RESELLER_SHOW", c.credentials, nil, &users); err != nil {
+		return nil, err
+	}
+
+	return users, nil
+}
+
+func (c *AdminContext) MoveUserToReseller(username string, reseller string) error {
+	if _, err := c.api.makeRequestN(http.MethodPost, "change-user-creator", c.credentials, convertAccount{Account: username, Creator: reseller}, nil); err != nil {
+		return err
+	}
+
+	return nil
+}

Diff for: auth.go

@@ -0,0 +1,143 @@
+package directadmin
+
+import (
+	"errors"
+	"fmt"
+	"net/http"
+	"strings"
+	"time"
+)
+
+type credentials struct {
+	username string
+	passkey  string
+}
+
+type LoginHistory struct {
+	Attempts  int       `json:"attempts"`
+	Host      string    `json:"host"`
+	Timestamp time.Time `json:"timestamp"`
+}
+
+func (c *AdminContext) GetLoginHistory() ([]*LoginHistory, error) {
+	var loginHistory []*LoginHistory
+
+	if _, err := c.api.makeRequestN(http.MethodGet, "login-history", c.credentials, nil, &loginHistory); err != nil {
+		return nil, fmt.Errorf("failed to get login history: %v", err)
+	}
+
+	if len(loginHistory) == 0 {
+		return nil, fmt.Errorf("no login history found")
+	}
+
+	return loginHistory, nil
+}
+
+func (c *UserContext) GetMyUsername() string {
+	// if user is logged in via reseller, we need to remove the reseller username from the context's username
+	if strings.Contains(c.credentials.username, "|") {
+		return strings.Split(c.credentials.username, "|")[1]
+	}
+
+	return c.credentials.username
+}
+
+func (c *UserContext) Login() error {
+	var response apiGenericResponse
+
+	if _, err := c.api.makeRequest(http.MethodGet, "API_LOGIN_TEST", c.credentials, nil, &response); err != nil {
+		return err
+	}
+
+	if response.Success != "Login OK" {
+		return errors.New("login failed")
+	}
+
+	return nil
+}
+
+// LoginAsAdmin verifies the provided credentials against the DA API, then returns an admin-level context.
+// The passkey can either be the user's password, or a login key
+func (a *API) LoginAsAdmin(username string, passkey string) (*AdminContext, error) {
+	userCtx, err := a.login(username, passkey)
+	if err != nil {
+		return nil, err
+	}
+
+	adminCtx := AdminContext{
+		ResellerContext{
+			UserContext: *userCtx,
+		},
+	}
+
+	if adminCtx.User.Config.UserType != AccountRoleAdmin {
+		return nil, fmt.Errorf("account is not an Admin, it is a %v", adminCtx.User.Config.UserType)
+	}
+
+	return &adminCtx, nil
+}
+
+// LoginAsReseller verifies the provided credentials against the DA API, then returns a reseller-level context.
+// The passkey can either be the user's password, or a login key
+func (a *API) LoginAsReseller(username string, passkey string) (*ResellerContext, error) {
+	userCtx, err := a.login(username, passkey)
+	if err != nil {
+		return nil, err
+	}
+
+	resellerCtx := ResellerContext{
+		UserContext: *userCtx,
+	}
+
+	if resellerCtx.User.Config.UserType != AccountRoleReseller {
+		return nil, fmt.Errorf("account is not an Reseller, it is a %v", resellerCtx.User.Config.UserType)
+	}
+
+	return &resellerCtx, nil
+}
+
+// LoginAsUser verifies the provided credentials against the DA API, then returns a user-level context.
+// The passkey can either be the user's password, or a login key
+func (a *API) LoginAsUser(username string, passkey string) (*UserContext, error) {
+	userCtx, err := a.login(username, passkey)
+	if err != nil {
+		return nil, err
+	}
+
+	if userCtx.User.Config.UserType != AccountRoleUser {
+		return nil, fmt.Errorf("account is not a User, it is a %v", userCtx.User.Config.UserType)
+	}
+
+	return userCtx, nil
+}
+
+func (c *AdminContext) LoginAsMyReseller(username string) (*ResellerContext, error) {
+	return c.api.LoginAsReseller(c.credentials.username+"|"+username, c.credentials.passkey)
+}
+
+func (c *ResellerContext) LoginAsMyUser(username string) (*UserContext, error) {
+	return c.api.LoginAsUser(c.credentials.username+"|"+username, c.credentials.passkey)
+}
+
+func (a *API) login(username string, passkey string) (*UserContext, error) {
+	userCtx := UserContext{
+		api: a,
+		credentials: credentials{
+			username: username,
+			passkey:  passkey,
+		},
+	}
+
+	if err := userCtx.Login(); err != nil {
+		return nil, err
+	}
+
+	userConfig, err := userCtx.GetMyUserConfig()
+	if err != nil {
+		return nil, err
+	}
+
+	userCtx.User.Config = *userConfig
+
+	return &userCtx, nil
+}