{"id":20156261,"url":"https://github.com/dsccommunity/xsafeharbor","last_synced_at":"2025-04-09T22:23:33.277Z","repository":{"id":30468263,"uuid":"34022249","full_name":"dsccommunity/xSafeHarbor","owner":"dsccommunity","description":null,"archived":false,"fork":false,"pushed_at":"2018-09-22T14:15:18.000Z","size":49,"stargazers_count":4,"open_issues_count":2,"forks_count":3,"subscribers_count":20,"default_branch":"dev","last_synced_at":"2025-03-24T00:16:50.815Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"PowerShell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/dsccommunity.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}},"created_at":"2015-04-15T22:43:05.000Z","updated_at":"2024-09-01T23:10:23.000Z","dependencies_parsed_at":"2022-08-22T23:40:32.391Z","dependency_job_id":null,"html_url":"https://github.com/dsccommunity/xSafeHarbor","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dsccommunity%2FxSafeHarbor","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dsccommunity%2FxSafeHarbor/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dsccommunity%2FxSafeHarbor/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dsccommunity%2FxSafeHarbor/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/dsccommunity","download_url":"https://codeload.github.com/dsccommunity/xSafeHarbor/tar.gz/refs/heads/dev","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248120932,"owners_count":21051051,"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-11-13T23:38:13.118Z","updated_at":"2025-04-09T22:23:33.249Z","avatar_url":"https://github.com/dsccommunity.png","language":"PowerShell","funding_links":[],"categories":[],"sub_categories":[],"readme":"[![Build status](https://ci.appveyor.com/api/projects/status/b30a0ayk2t21kg7j/branch/master?svg=true)](https://ci.appveyor.com/project/PowerShell/xsafeharbor/branch/master)\r\n\r\n# xSafeHarbor\r\n\r\nThe **xSafeHarbor** module contains the DSC configurations that allow you to setup the **SafeHarbor** example.\r\n\r\nThis project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).\r\nFor more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.\r\n\r\n## Contributing\r\nPlease check out common DSC Resources [contributing guidelines](https://github.com/PowerShell/DscResource.Kit/blob/master/CONTRIBUTING.md).\r\n\r\n\r\n## Description\r\n\r\nThe **xSafeHarbor** module contains the **Assert-SafeHarborScenario.ps1** script file.\r\nThis script allows you to exercise the **SafeHarbor** example by setting up a secure environment to run a particular application or service inside of an assume-breached network.\r\nThis substantially reduces the attack surface of the application or service by configuring a highly customized, application specific environment, by limiting user access and by having \"Just Enough\" administrative control with full auditing.\r\n\r\nTo learn more details about this example, please see [this blog post](http://blogs.msdn.com/b/powershell/archive/2014/07/21/creating-a-secure-environment-using-powershell-desired-state-configuration.aspx).\r\n\r\nNote: This example require the use of [Windows Management Framework (WMF) 5.0 Preview](http://go.microsoft.com/fwlink/?LinkId=398175).\r\n\r\n\r\n## Details\r\n\r\n### Assert-SafeHarborScenario\r\n\r\n* **BaseVhdFilePath**: (Mandatory) Path to VHD file that would be used as base image for all the VMs.\r\n* **Credentials**: Collection of credentials for following user names.\r\nIf not specified, the script will prompt for:\r\n    - DHCPServer\\Administrator\r\n    - Corporate\\Administrator\r\n    - Corporate\\User1\r\n    - Corporate\\Papa\r\n    - Corporate\\DeptHead\r\n    - Safeharbor\\Administrator\r\n    - Safeharbor\\Mata\r\n* **VhdDestinationPath**: Path where differencing VHDs will be stored.\r\n* **Validate**: If specified, will run the validation steps at the end of example.\r\n* **PauseBetweenStages**: If specified, pauses the script execution between various stages of example setup\r\n\r\n## Versions\r\n\r\n### Unreleased\r\n\r\n* Update appveyor.yml to use the default template.\r\n* Added default template files .codecov.yml, .gitattributes, and .gitignore, and\r\n  .vscode folder.\r\n* Updated configuration SafeHarborConfiguration.psm1 to pass tests.\r\n\r\n### 1.0.0.1\r\n\r\n* Minor bug fix: Replaced hardcoded hotfix ID for WMF with test for that version or higher.\r\n\r\n### 1.0.0.0\r\n\r\n* Initial release with the **SafeHarbor** example\r\n\r\n\r\n## Examples\r\n\r\n### Setup SafeHarbor example on a Hyper-V host\r\n\r\n```powershell\r\n$baseVhdFilePath = ‘C:\\BaseVhd\\serverdatacenter_en-us.vhd\r\n.\\Assert-SafeHarborScenario.ps1 -BaseVhdFilePath $baseVhdFilePath -Validate –PauseBetweenStages\r\n```\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdsccommunity%2Fxsafeharbor","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdsccommunity%2Fxsafeharbor","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdsccommunity%2Fxsafeharbor/lists"}