{"id":13619781,"url":"https://github.com/openconnect/ocserv","last_synced_at":"2025-04-14T18:32:24.362Z","repository":{"id":55053626,"uuid":"58871907","full_name":"openconnect/ocserv","owner":"openconnect","description":"Unofficial copy of ocserv repository (no longer updated)","archived":true,"fork":false,"pushed_at":"2021-02-22T16:25:46.000Z","size":5528,"stargazers_count":388,"open_issues_count":1,"forks_count":99,"subscribers_count":27,"default_branch":"master","last_synced_at":"2024-11-08T06:38:17.156Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://gitlab.com/ocserv/ocserv","language":"C","has_issues":false,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/openconnect.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"COPYING","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2016-05-15T16:25:30.000Z","updated_at":"2024-10-25T03:42:41.000Z","dependencies_parsed_at":"2022-08-14T10:20:09.531Z","dependency_job_id":null,"html_url":"https://github.com/openconnect/ocserv","commit_stats":null,"previous_names":[],"tags_count":81,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/openconnect%2Focserv","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/openconnect%2Focserv/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/openconnect%2Focserv/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/openconnect%2Focserv/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/openconnect","download_url":"https://codeload.github.com/openconnect/ocserv/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248936911,"owners_count":21186124,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":[],"created_at":"2024-08-01T21:00:48.634Z","updated_at":"2025-04-14T18:32:23.071Z","avatar_url":"https://github.com/openconnect.png","language":"C","funding_links":[],"categories":["C"],"sub_categories":[],"readme":"# About\n\nThis program is openconnect VPN server (ocserv), a server for the\n[openconnect VPN client](http://www.infradead.org/openconnect/).\nIt follows the [openconnect protocol](https://gitlab.com/openconnect/protocol)\nand is believed to be compatible with CISCO's AnyConnect SSL VPN. \n\nThe program consists of:\n 1. ocserv, the main server application\n 2. occtl, the server's control tool. A tool which allows one to query the\n   server for information.\n 3. ocpasswd, a tool to administer simple password files.\n\n\n# Supported platforms\n\nThe OpenConnect VPN server is designed and tested to work, with both IPv6\nand IPv4, on Linux systems. It is, however, known to work on FreeBSD,\nOpenBSD and other BSD derived systems.\n\nKnown limitation is that on platforms, which do not support procfs(5),\nchanges to the configuration must only be made while ocserv(8) is stopped.\nNot doing so will cause new worker processes picking up the new\nconfiguration while ocserv-main will use the previous configuration.\n\n\n# Build dependencies\n\nRequired dependencies (Debian pkg/Fedora pkg):\n```\nlibgnutls28-dev      / gnutls-devel\nlibev-dev            / libev-devel\n```\n\nOptional dependencies that enable specific functionality:\n```\nTCP wrappers: libwrap0-dev        / tcp_wrappers-devel\nPAM:          libpam0g-dev        / pam-devel\nLZ4:          liblz4-dev          / lz4-devel\nseccomp:      libseccomp-dev      / libseccomp-devel\nocctl:        libreadline-dev     / readline-devel\n              libnl-route-3-dev   / libnl3-devel\nGSSAPI:       libkrb5-dev         / krb5-devel\nRadius:       libradcli-dev       / radcli-devel\nOIDC:\t      libcurl4-gnutls-dev / libcurl-devel\n\t      libcjose-dev        / cjose-devel\n\t      libjansson-dev\t  / jansson-devel\n```\n\nDependencies for development, testing, or dependencies that can be skipped\nin an embedded system (e.g., because a replacement library is included):\n\n```\nlibprotobuf-c-dev  / protobuf-c-devel\nlibtalloc-dev      / libtalloc-devel\nlibhttp-parser-dev / http-parser-devel\nprotobuf-c-compiler/ protobuf-c\ngperf              / gperf\nnuttcp             / nuttcp\nlcov               / lcov\nlibuid-wrapper     / uid_wrapper\nlibpam-wrapper     / pam_wrapper\nlibnss-wrapper     / nss_wrapper\nlibsocket-wrapper  / socket_wrapper\ngss-ntlmssp        / gssntlmssp\nhaproxy            / haproxy\niputils-ping       / iputils\nfreeradius\t   / freeradius\ngawk\t\t   / gawk\ngnutls-bin\t   / gnutls-utils\niproute2\t   / iproute\nyajl-tools\t   / yajl\niproute2\t   / iproute\ntcpdump      / tcpdump\n```\n\nSee [README-radius](doc/README-radius.md) for more information on Radius\ndependencies and its configuration.\n\n# Build instructions\n\nTo build from a distributed release use:\n\n```\n$ ./configure \u0026\u0026 make \u0026\u0026 make check\n```\n\nTo test the code coverage of the test suite use the following:\n```\n$ ./configure --enable-code-coverage\n$ make \u0026\u0026 make check \u0026\u0026 make code-coverage-capture\n```\n\nNote that the code coverage reported does not currently include tests which\nare run within docker.\n\nIn addition to the prerequisites listed above, building from git requires\nthe following packages: autoconf, automake, and xz.\n\nTo build from the git repository use:\n```\n$ autoreconf -fvi\n$ ./configure \u0026\u0026 make\n```\n\n\n# Basic installation instructions\n\nNow you need to generate a certificate. E.g.\n```\n$ certtool --generate-privkey \u003e ./test-key.pem\n$ certtool --generate-self-signed --load-privkey test-key.pem --outfile test-cert.pem\n```\n(make sure you enable encryption or signing)\n\n\nCreate a dedicated user and group for the server unprivileged processes\n(e.g., 'ocserv'), and then edit the [sample.config](doc/sample.config)\nand set these users on run-as-user and run-as-group options. The run:\n```\n# cd doc \u0026\u0026 ../src/ocserv -f -c sample.config\n```\n\n# Configuration\n\nSeveral configuration instruction are available in [the recipes repository](https://gitlab.com/openconnect/recipes).\n\n\n# Profiling\n\nIf you use ocserv on a server with significant load and you'd like to help\nimprove it, you may help by sending profiling information. That includes\nthe bottlenecks in software, so future optimizations could be spent on the\nreal needs. \n\nIn a Linux system you can profile ocserv using the following command.\n```\n# perf record -g ocserv\n```\n\nAfter the server is terminated, the output is placed in perf.data.\nYou may examine the output using:\n```\n# perf report\n```\n\n\n# Continuous Integration (CI)\n\nWe utilize the gitlab-ci continuous integration system. It is used to test\nmost of the Linux systems (see .gitlab-ci.yml),and is split in two phases,\nbuild image creation and compilation/test. The build image creation is done\nat the openconnect/build-images subproject and uploads the image at the gitlab.com\ncontainer registry. The compilation/test phase is on every commit to project.\n\n\n# How the VPN works\n\nPlease see the [technical description page](http://ocserv.gitlab.io/www/technical.html).\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fopenconnect%2Focserv","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fopenconnect%2Focserv","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fopenconnect%2Focserv/lists"}