{"id":24503596,"url":"https://github.com/plus3it/forescout-secure-connector-formula","last_synced_at":"2026-01-03T03:09:35.528Z","repository":{"id":70263166,"uuid":"536708063","full_name":"plus3it/forescout-secure-connector-formula","owner":"plus3it","description":"Salt formula for managing Forescout Secure Connector","archived":false,"fork":false,"pushed_at":"2025-01-06T14:28:28.000Z","size":108,"stargazers_count":0,"open_issues_count":1,"forks_count":2,"subscribers_count":4,"default_branch":"main","last_synced_at":"2025-01-21T23:17:43.367Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Jinja","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/plus3it.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}},"created_at":"2022-09-14T18:20:17.000Z","updated_at":"2024-09-14T21:02:23.000Z","dependencies_parsed_at":"2024-08-01T23:47:47.221Z","dependency_job_id":"e28765a8-5a40-41de-811d-e688e519c9f9","html_url":"https://github.com/plus3it/forescout-secure-connector-formula","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/plus3it%2Fforescout-secure-connector-formula","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/plus3it%2Fforescout-secure-connector-formula/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/plus3it%2Fforescout-secure-connector-formula/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/plus3it%2Fforescout-secure-connector-formula/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/plus3it","download_url":"https://codeload.github.com/plus3it/forescout-secure-connector-formula/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243703777,"owners_count":20334036,"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":"2025-01-21T23:17:49.846Z","updated_at":"2026-01-03T03:09:35.445Z","avatar_url":"https://github.com/plus3it.png","language":"Jinja","funding_links":[],"categories":[],"sub_categories":[],"readme":"# forescout-secure-connector-formula\n\nThis Salt formula will install the ForeScout Secure Connector agent. The installer\nis an archive generated by the ForeScout server and includes all information needed\nto link to the server.\n\nThe states in this formula are entirely configurable through pillar. See the\nsections below for a description of the pillar keys.\n\n## Available States\n\n-   [forescout-secure-connector](#forescout-secure-connector)\n-   [forescout-secure-connector.clean](#forescout-secure-connector.clean)\n-   [forescout-secure-connector.package](#forescout-secure-connector.package)\n-   [forescout-secure-connector.service](#forescout-secure-connector.service)\n\n### forescout-secure-connector\n\nExecutes the `package` and `service` states to install and manage the ForeScout\nSecure Connector.\n\n### forescout-secure-connector.clean\n\nThe `clean` state will remove all ForeScout Secure Connector components that are\nmanaged by this formula.\n\n### forescout-secure-connector.package\n\nThe `package` state ensures the ForeScout Secure Connector is installed.\n\n### forescout-secure-connector.service\n\nThe `service` state ensures the ForeScout Secure Connector service is running and enabled.\n\n## Configuration\n\nThe only _required_ configuration settings are the archive source URL and its source\nhash, i.e. `package:archive:source` and `package:archive:source_hash`. Those are\nspecific to the ForeScout server and the environment where this formula is used.\n\nAll other settings are optional. The formula sets reasonable, sane defaults for\noptional settings.\n\nAll settings must be located in the Salt Pillar, within the `forescout-secure-connector:lookup`\ndictionary.\n\n### `forescout-secure-connector:lookup:package:archive:source`\n\nURL to the ForeScout Secure Connector archive.\n\n\u003e**Required**: `True`\n\n**Example**:\n\n```yaml\nforescout-secure-connector:\n  lookup:\n    package:\n      archive:\n        source: https://url/to/forescout/archive.tgz\n```\n\n### `forescout-secure-connector:lookup:package:archive:source_hash`\n\nURL containing the source hash of the archive, or the hash value.\n\n\u003e**Required**: `True`\n\n**Example**:\n\n```yaml\nforescout-secure-connector:\n  lookup:\n    package:\n      archive:\n        source_hash: source_hash_url_or_value\n```\n\n### `forescout-secure-connector:lookup:package:install_dir`\n\nLocation on the filesystem where the ForeScout agent expects to be installed.\n\n\u003e**Required**: `False`\n\u003e\n\u003e**Default**: `/usr/lib/forescout`\n\n**Example**:\n\n```yaml\nforescout-secure-connector:\n  lookup:\n    package:\n      install_dir: /usr/lib/forescout\n```\n\n### `forescout-secure-connector:lookup:package:install_cmd`\n\nCommand the ForeScout archive provides to install the Secure Connector. This command\nis executed from the archive directory, after extracting the archive.\n\n\u003e**Required**: `False`\n\u003e\n\u003e**Default**: `secure_connector/install.sh`\n\n**Example**:\n\n```yaml\nforescout-secure-connector:\n  lookup:\n    package:\n      install_cmd: secure_connector/install.sh\n```\n\n### `forescout-secure-connector:lookup:package:installed_test`\n\nCommand that tests whether to run the ForeScout install command\n\n\u003e**Required**: `False`\n\u003e\n\u003e**Default**: `test -d /usr/lib/forescout/daemon`\n\n**Example**:\n\n```yaml\nforescout-secure-connector:\n  lookup:\n    package:\n      installed_test: test -d /usr/lib/forescout/daemon\n```\n\n### `forescout-secure-connector:lookup:package:uninstall_cmd`\n\nCommand used in the `clean` state to uninstall the ForeScout Secure Connector.\n\n\u003e**Required**: `False`\n\u003e\n\u003e**Default**: `/usr/lib/forescout/Uninstall.sh`\n\n**Example**:\n\n```yaml\nforescout-secure-connector:\n  lookup:\n    package:\n      uninstall_cmd: /usr/lib/forescout/Uninstall.sh\n```\n\n### `forescout-secure-connector:lookup:package:uninstall_test`\n\nCommand used in the `clean` state that tests whether the ForeScout uninstall command\nis available.\n\n\u003e**Required**: `False`\n\u003e\n\u003e**Default**: `test -x /usr/lib/forescout/Uninstall.sh`\n\n**Example**:\n\n```yaml\nforescout-secure-connector:\n  lookup:\n    package:\n      uninstall_test: test -x /usr/lib/forescout/Uninstall.sh\n```\n\n### `forescout-secure-connector:lookup:package:archive:extract_directory`\n\nDirectory where the archive will be extracted\n\n\u003e**Required**: `False`\n\u003e\n\u003e**Default**: `{{ salt.config.get('cachedir') }}/files/base/forescout-secure-connector/package/archive/forescout`\n\n**Example**:\n\n```yaml\nforescout-secure-connector:\n  lookup:\n    package:\n      archive:\n        extract_directory: {{ salt.config.get('cachedir') }}/files/base/forescout-secure-connector/package/archive/forescout\n```\n\n### `forescout-secure-connector:lookup:package:daemon:name`\n\nName of the `daemon` package required by forescout.\n\n\u003e**Required**: `False`\n\u003e\n\u003e**Default**: `/root/forescout`\n\n**Example**:\n\n```yaml\nforescout-secure-connector:\n  lookup:\n    package:\n      daemon:\n        name: daemon\n```\n\n### `forescout-secure-connector:lookup:package:daemon:source`\n\nUrl to the file that installs the `daemon` package. When not provided, the archive\ninstaller will connect to the ForeScout server to retrieve and install the `daemon`\npackage.\n\n\u003e**Required**: `False`\n\u003e\n\u003e**Default**: `None`\n\n**Example**:\n\n```yaml\nforescout-secure-connector:\n  lookup:\n    package:\n      daemon:\n        source: https://url/to/daemon/pkg.rpm\n```\n\n### `forescout-secure-connector:lookup:package:daemon:source`\n\nName of the ForeScout Secure Connector service\n\n\u003e**Required**: `False`\n\u003e\n\u003e**Default**: `SecureConnector`\n\n**Example**:\n\n```yaml\nforescout-secure-connector:\n  lookup:\n    service:\n      name: SecureConnector\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fplus3it%2Fforescout-secure-connector-formula","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fplus3it%2Fforescout-secure-connector-formula","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fplus3it%2Fforescout-secure-connector-formula/lists"}