{"id":21293063,"url":"https://github.com/criteo/kerberos-docker","last_synced_at":"2026-02-13T07:37:40.891Z","repository":{"id":24963399,"uuid":"102866187","full_name":"criteo/kerberos-docker","owner":"criteo","description":"Run kerberos environment in docker containers","archived":false,"fork":false,"pushed_at":"2025-09-26T09:10:06.000Z","size":15973,"stargazers_count":134,"open_issues_count":4,"forks_count":48,"subscribers_count":12,"default_branch":"main","last_synced_at":"2025-09-26T11:17:46.308Z","etag":null,"topics":["devops","docker","kerberos","security"],"latest_commit_sha":null,"homepage":null,"language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/criteo.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2017-09-08T13:47:50.000Z","updated_at":"2025-09-26T09:01:43.000Z","dependencies_parsed_at":"2025-01-26T03:01:46.124Z","dependency_job_id":"d6dd12a6-e94a-44d3-978a-583f1fab86e5","html_url":"https://github.com/criteo/kerberos-docker","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/criteo/kerberos-docker","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/criteo%2Fkerberos-docker","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/criteo%2Fkerberos-docker/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/criteo%2Fkerberos-docker/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/criteo%2Fkerberos-docker/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/criteo","download_url":"https://codeload.github.com/criteo/kerberos-docker/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/criteo%2Fkerberos-docker/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29398787,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-13T06:24:03.484Z","status":"ssl_error","status_checked_at":"2026-02-13T06:23:12.830Z","response_time":78,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["devops","docker","kerberos","security"],"created_at":"2024-11-21T13:53:07.775Z","updated_at":"2026-02-13T07:37:40.884Z","avatar_url":"https://github.com/criteo.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# README - Kerberos/Docker\n\n[![Build status](https://github.com/criteo/kerberos-docker/actions/workflows/ci.yml/badge.svg)](https://github.com/criteo/kerberos-docker/actions/workflows/ci.yml)\n\nKerberos/Docker is a project that enables the easy deployment of a **MIT Kerberos V5** architecture in a cluster of **Docker containers**. It is beneficial for running integration tests on projects using Kerberos, as well as for learning and testing Kerberos solutions and administration.\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"./doc/kerberos-docker-logo.png\" width=200/\u003e\n\u003c/p\u003e\n\nSee [MIT Kerberos V5](https://web.mit.edu/kerberos/) and [Docker](https://www.docker.com/), and browse the code with [SourceGraph](https://sourcegraph.com/github.com/criteo/kerberos-docker).\n\n## Prerequisites\n\nUse an **operating system compatible with docker**, and install:  \n- **Docker engine** (without `sudo` for running the `docker` command and with `overlay2` driver).  \n- **Docker compose**\n- [GNU Make](https://www.gnu.org/software/make/make.html) (if not already available).  \n- [GNU Bash](https://www.gnu.org/software/bash/bash.html) (if not already available).\n\nOnly if you want to generate other Docker configurations, install:\n- **Python 3** (if not already available, with `pip` and `venv`).\n\nOnly if you want to use Java on your host machine:\n- **Java 8 and Maven 3** (if not already available).  \n\nTo check the compatible version, see the traces of the `Check version` on GitHub actions (CI) web interface, see [here](https://github.com/criteo/kerberos-docker/actions).  \n\nTo run tests, install [Bats](https://github.com/bats-core/bats-core), see `./.ci/install.sh`.\n\nNote:\n- For Linux and macOS workstations, it works on all distributions. \n- For Windows workstations, it works on [Windows Subsystem for Linux](https://docs.microsoft.com/en-us/windows/wsl/about), but you should connect to the Docker container to interact with the Kerberos server. \n\n## Usage \u0026 Documentation\n\nAfter installation, there are three containers with a web server on each one to check if it turns:\n\n- `krb5-machine-example-com`\n- `krb5-kdc-server-example-com`\n- `krb5-service-example-com`\n\nThe goal is to connect from `krb5-machine-example-com` to `krb5-service-example-com` with SSH and Kerberos authentication (using GSSAPIAuthentication).\n\nHere is the cluster architecture:\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"./doc/kerberos-docker-architecture.png\" width=700/\u003e\n\u003c/p\u003e\n\nRead more about the documentation in [doc](./doc) folder.\n\n## Installation\n\nExecute:\n\n~~~\nmake install\n~~~\n\nIt will use the `./build-ubuntu-example-com` folder, with Docker containers under `Ubuntu` and with the Kerberos realm `EXAMPLE.COM`.\nIf you want to use another OS for the Docker containers and/or other Kerberos realm, you need to use `make gen-conf`, see the `Prerequisites` section.\n\nSee `Makefile` with `make usage` for all commands.\n\n## Uninstallation\n\nExecute:\n\n~~~\nmake clean\n~~~\n\nTo delete `network-analyser`, do `./network-analyser/clean-network-analyser.sh`.\n\nFor the Ubuntu operating system in the Docker container:\n\nTo delete `ubuntu:24.04` and `minimal-ubuntu:latest` Docker images, do `docker rmi ubuntu:24.04 minimal-ubuntu`.\n\n## Test\n\nThis project is tested with\n[Bash Automated Testing System (BATS)](https://github.com/bats-core/bats-core).\n\n\nAfter installing `BATS` (see version in Prerequisites part) and the environment of containers to test, do: \n\n~~~\nmake test\n~~~\n\n##  Continuous Integration (CI)\n\nThis project uses continuous integration with [GitHub Actions](https://github.com/features/actions).  \n\nView all workflow runs on the CI [here](https://github.com/criteo/kerberos-docker/actions/workflows/ci.yml).\n\n## Network analyzer\n\nYou can create a [Wireshark](https://www.wireshark.org/) instance running in a Docker container built from a Docker image named `network-analyser`.\n\nSee more details in `./network-analyser/README.md`.\n\n## Debug and see traces\n\nYou can connect with an interactive session to a Docker container:\n\n~~~\ndocker exec -it \u003ccontainer_name_or_id\u003e bash\n~~~\n\nTo debug Kerberos client or server:\n\n~~~\nexport KRB5_TRACE=/dev/stdout\n~~~\n\nTo debug the SSH client:\n\n~~~~\nssh -vvv username@host\n~~~~\n\nTo debug the ssh server:\n\n~~~~\n/usr/sbin/sshd -f /etc/ssh/sshd_config -d -e\n~~~~\n\n## Troubleshooting\n\n**Kerberos services**\n\nOn `krb5-kdc-server-example-com` Docker container, there are 2 Kerberos services `krb5-admin-service` and `krb5-kdc`:\n\n~~~\nsupervisorctl status\n~~~\n\nSee all opened ports on a machine:\n\n~~~\nnetstat -tulpn\n~~~\n\n\nCheck that each machine has a synchronized time (with `ntp` protocol and `date` to check).\n\nSee [Troubleshooting](https://web.mit.edu/kerberos/krb5-latest/doc/admin/troubleshoot.html) and\n[Kerberos reserved ports](https://web.mit.edu/kerberos/krb5-1.5/krb5-1.5.4/doc/krb5-admin/Configuring-Your-Firewall-to-Work-With-Kerberos-V5.html).\n\n**Conflict private IP addresses**\n\nTo create `example.com` network Docker, the private sub-network `10.5.0.0/24`\nshould be free and private IP addresses `10.5.0.0/24` should be free also. Check\nyour routing table with `route -n`, test free IP addresses with\n`ping -c 1 -w 2 \u003chost\u003e`, and check request paths with `traceroute \u003chost\u003e`.\n\nIf the issue persists, you can do `make clean` or `docker network rm example.com`.\n\n**Working on your computer (host machine) for debugging code**\n\nModify your `/etc/hosts` to resolve bidirectionally IP addresses with the DNS of the Kerberos cluster:\n\n~~~\n# /etc/hosts\n# ...\n\n# Kerberos cluster\n# IP FQDN hostname\n10.5.0.1\tkrb5-machine-example-com.example.com krb5-machine-example-com\n10.5.0.2\tkrb5-kdc-server-example-com.example.com krb5-kdc-server-example-com\n10.5.0.3\tkrb5-service-example-com.example.com krb5-service-example-com\n\n# ...\n~~~\n\nYou can `ping krb5-kdc-server-example-com|10.5.0.2` Kerberos KDC server, and check if\nKerberos server port is opened: `nmap -A 10.5.0.2/32 -p 88` (or if SSH\nserver port: `nmap -A 10.5.0.3/32 -p 22`).\n\nNow you can debug code and run `kinit bob` directly on the host machine.\n\nThe order of `entries` and `names` is essential in `/etc/hosts`.\nTo resolve a name from an IP address, the resolver takes the first one (horizontally) if multiple names\nare possible; and to resolve IP address from the name, the resolver takes the first entry (vertically)\nif multiple IP addresses are possible: You can use `resolveip \u003cIP|name\u003e`, `getent hosts \u003cIP|name\u003e`\nOr take a look at `/etc/hosts`.\n\n## Possible improvements\n\n* Add LDAP as a database for the Kerberos architecture\n* Add other connectors and services (PostgreSQL, MongoDB, nfs, Hadoop), only OpenSSH for the moment\n* Add Java, Python, or C to connect with Kerberos authentication\n\n## References\n\n* ROBINSON Trevor (eztenia). **Kerberos**. Canonical Ltd. Ubuntu Article, November 2014. Link: https://help.ubuntu.com/community/Kerberos.\n* MIGEON Jean. **Protocol, Installation and Single Sign On, The MIT Kerberos Admnistrator's how-to Guide**. MIT Kerberos Consortium, July 2008. p 62.\n* BARRETT Daniel, SILVERMAN Richard, BYRNES Robert. **SSH, The Secure Shell: The Definitive Guide, 2nd Edition**. O'Reilly Media, June 2009. p. 672. Notes: Chapter 11. ISBN-10: 0596008953, ISBN-13: 978-0596008956\n* GARMAN, Jason. **Kerberos: The Definitive Guide, 2nd Edition**. O'Reilly Media, March 2010. p. 272.  ISBN-10: 0596004036, ISBN-13: 978-0596004033.\n* O’MALLEY Owen, ZHANG Kan, RADIA Sanjay, MARTI Ram, and HARRELL Christopher. **Hadoop Security Design**. Yahoo! Research Paper, October 2009. p 19.\n*  MATTHIAS Karl, KANE Sean. **Docker: Up \u0026 Running**. O'Reilly Media, June 2015. p. 232. ISBN-10: 1491917571, ISBN-13: 978-1491917572.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcriteo%2Fkerberos-docker","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcriteo%2Fkerberos-docker","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcriteo%2Fkerberos-docker/lists"}