Difference between revisions of "GSOC cockpit samba ad dc"

m (Contact Management)
m (Delegation Management)
Line 110: Line 110:
  
 
• Any Protocol
 
• Any Protocol
+
[[File:Cockpit-plugin_delegation_management.png|950px]]
 +
 
 
== DNS Management ==
 
== DNS Management ==
  

Revision as of 12:18, 27 August 2020

Cockpit Samba AD DC Plugin Documentation

What is Cockpit?

To work with the plugin, you need to have Cockpit installed. As per Cockpit’s documentation it’s an "easy-to-use, integrated, glanceable, and open web-based interface for your servers" (https://cockpit-project.org/) Cockpit helps you manage your Linux servers using a user interface that runs in a browser. It also lets developers develop their own plugins using an API cockpit provides for interacting with the server. This project sought to incorporate tasks done using the samba-tool command line utility for Samba AD DC in an intuitive UI for easier usage and administration.

Installation

Fedora 32 Installation

Prerequisite: Cockpit

1. Download the repository https://download.opensuse.org/repositories/home:/Hezekiah/Fedora_32/home:Hezekiah.repo

2. Place it to /etc/yum.repos.d/

3. Run the following command

# dnf install cockpit-samba-ad-dc

4. If you already have Cockpit on your server, point your web browser to: https://ip-address-of-machine:9090

5. Use your system user account and password to log in.

Ubuntu 20.04 Installation

Prerequisite: Cockpit

1. Update the apt package index and install packages to allow apt to use a repository over HTTPS:

$ sudo apt update
$ sudo apt-get install apt-transport-https ca-certificates curl gnupg-agent software-properties-common

2. Add Cockpit-Samba-AD-DC GPG key:

$ curl -fsSL https://download.opensuse.org/repositories/home:/Hezekiah/xUbuntu_20.04/Release.key | sudo apt-key add -

3. Add the repository to the sources.list file

$ sudo add-apt-repository "deb https://download.opensuse.org/repositories/home:/Hezekiah/xUbuntu_20.04 ./"

4. Update the apt package index, and download the latest version of Cockpit-Samba-AD-DC plugin.

$ sudo apt-get update
$ sudo apt-get install cockpit-samba-ad-dc

5. If you already have Cockpit on your server, point your web browser to: https://ip-address-of-machine:9090

6. Use your system user account and password to log in.

Debian 10 Installation

Prerequisite: Cockpit

1. Update the apt package index and install packages to allow apt to use a repository over HTTPS:

$ sudo apt update
$ sudo apt-get install apt-transport-https ca-certificates curl gnupg-agent software-properties-common

2. Add Cockpit-Samba-AD-DC GPG key:

$ curl -fsSL https://download.opensuse.org/repositories/home:/Hezekiah/Debian_10/Release.key | sudo apt-key add -

3. Add the repository to the sources.list file

$ sudo add-apt-repository "deb https://download.opensuse.org/repositories/home:/Hezekiah/Debian_10 ./"

4. Update the apt package index, and download the latest version of Cockpit-Samba-AD-DC plugin.

$ sudo apt-get update
$ sudo apt-get install cockpit-samba-ad-dc

5. If you already have Cockpit on your server, point your web browser to: https://ip-address-of-machine:9090

6. Use your system user account and password to log in

Using the Plugin

Provisioning an AD DC Domain

When you run the plugin in cockpit, it first checks the Samba Configuration file to make sure that the server is set as an Active Directory Domain Controller (AD DC). If the server is not, the user is prompted with to set one. Once ready, a page with a list of activities you can perform with the plugin (a page reload may be required) Cockpit-samba-ad-dc main page.png

Computer Management

Using the plugin you can:

• Create a computer

• Delete a computer

• Display a Computer Active Directory object

• List all computers

• Move a computer to an organizational unit/container.

Cockpit-plugin computer magement.png

Contact Management

• Creating a Contact

• Deleting a Contact

• Listing all Contacts

• Showing a Contact

Cockpit-plugin contact management.png

Delegation Management

• Adding a Service

• Deleting a Service

• Show a Service Object

• Any Service

• Any Protocol Cockpit-plugin delegation management.png

DNS Management

• Creating a DNS record

• Deleting a DNS record

• Cleanup DNS records

• Query for server information

• Creating zones

• Deleting zones

• Showing zone information

Domain Management

• Promote an existing domain member to Domain Controller (DC)

• Getting domain information

• Demote a Domain Controller

• Join a domain as a member or backup Domain Controller

• Upgrade from Samba classic (NT4-like) database to Samba AD DC database

• Creating a Trust

• Deleting Trust

• Listing Trusts

• Show a trust's Object

• Validate Trusts

• Namespaces

• Backup Online

• Backup Offline

• Rename

• Restore

Forest Management

• Show

• DSHeuristics

FSMO Management

• Seize Roles

• Show Roles

• Transfer Roles

Group Policy Object Management

• Creating a GPO

• Deleting a GPO

• Backing up a GPO

• Deleting link

• Fetching

• Getting Inheritance

• Getting Link

• Listing GPOs

• Listing All GPOs

• Listing Containers

• Restoring a GPO

• Setting Inheritance

• Setting Link

• Showing a GPO Object

Group Management

• Creating Groups

• Deleting Groups

• Listing Groups

• Listing Members

• Moving groups

• Removing members

• Showing a Group Object

Organization Unit (OU) Management

• Creating an OU

• Deleting an OU

• Listing OUs

• Listing Objects in an OU

• Renaming OUs

• Moving an OU

Sites Management

• Creating a Site

• Creating Subnets

• Removing a Site

• Setting a Site

• Removing a Subnet

SPN Management

• Adding

• Deleting

• Listing

User Management

• Creating a user

• Deleting a user

• Disabling a user

• Enabling a user

• Listing users

• Moving a user

• Change a User’s password

• Setting Password

• Setting Expiry Date

• Showing a User

Server Time