{"_id":"599458d2afa440002f69d501","project":"55db8f8f1a91690d007ad975","version":{"_id":"55db8f901a91690d007ad978","project":"55db8f8f1a91690d007ad975","__v":17,"createdAt":"2015-08-24T21:41:36.034Z","releaseDate":"2015-08-24T21:41:36.034Z","categories":["55db8f901a91690d007ad979","55db9856b3d6540d00886426","55dc751b00a8811900c230e3","55dc766255be9f21004ee250","55dc769200a8811900c230ed","55e4c701177b6e0d003330fa","55f4915caf0bc71900a53130","55f491b2be9c2b2100f0635d","560b22739c7be70d00100bd8","57488c53e8c6a420000b729c","574cefd95953e20e00f40f9f","5798edfd7700d30e00ad250c","579ac88234b5fd0e00b9e140","57c81c6d690c200e0047b72e","57d9b8fbda17c30e003897f1","57d9b90e608ea00e00f358d8","57d9b91cda17c30e003897f4"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"","version_clean":"1.0.0","version":"1.0"},"category":{"_id":"55dc751b00a8811900c230e3","pages":["55dc75b27fa0290d00559123","55dc75c055be9f21004ee24e","55dc75ef00a8811900c230e7","55dc76036f16451700843e0c","55dc760e00a8811900c230e9","55dc767d55be9f21004ee251","55df5db386ae7f0d00db4ccd","55df64cfaf76b70d0060a60e","55df7263c59b180d005fa70e","55e0b72fa44fae0d002148c5","55e0c42b5087cb1900986c0f","55e36b1bac4eef230079a735","55f363ea2d3bae21009c47aa","55f36bcc5f8674370067b73c","55f36c23ec46040d0030326a","5605d2eda4574a0d00811346","560ac5fef6994b0d0023bca6","561be02937781d0d007942b0","56782f0048c8d00d0094b7fc"],"project":"55db8f8f1a91690d007ad975","version":"55db8f901a91690d007ad978","__v":19,"sync":{"url":"","isSync":false},"reference":false,"createdAt":"2015-08-25T14:00:59.500Z","from_sync":false,"order":1,"slug":"how-to-get-started","title":"Agent Installation"},"user":"573de28a844afa29000d5c3a","githubsync":"","__v":2,"parentDoc":null,"updates":["59ea2124c18204001a438386","59ea21f0c18204001a438398"],"next":{"pages":[],"description":""},"createdAt":"2017-08-16T14:38:10.582Z","link_external":false,"link_url":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":12,"body":"[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/531663f-microsoft_.net_.png\",\n        \"microsoft_.net_.png\",\n        200,\n        200,\n        \"#0f87c3\"\n      ]\n    }\n  ]\n}\n[/block]\n\n[block:api-header]\n{\n  \"title\": \"Supported Versions\"\n}\n[/block]\n\n[block:parameters]\n{\n  \"data\": {\n    \"h-0\": \"\",\n    \"h-1\": \".NET Framework\",\n    \"h-2\": \".NET Framework\",\n    \"0-0\": \".NET Framework version\",\n    \"0-1\": \"4.5.2 and above\",\n    \"0-2\": \"4.5.2 and above\",\n    \"1-0\": \"Operating Systems\",\n    \"1-1\": \"Windows Server 2008 Service Pack 2 and up\",\n    \"1-2\": \"Windows\",\n    \"3-0\": \"Account Protection\",\n    \"3-1\": \"Through instrumentation of [System.Web.Security.Membership](https://msdn.microsoft.com/en-us/library/system.web.security.membership.aspx) as well as Immunio Authentication API\",\n    \"3-2\": \"Through instrumentation of [System.Web.Security.Membership](https://msdn.microsoft.com/en-us/library/system.web.security.membership.aspx) as well as Immunio Authentication API,\",\n    \"4-0\": \"Code Protection\",\n    \"4-2\": \"SQLi, RCE, FileIO, Redirect, XSS\",\n    \"5-0\": \"SQL Database\",\n    \"5-2\": \"MSSQL\",\n    \"2-0\": \"Architecture\",\n    \"2-1\": \"64 bits\",\n    \"2-2\": \"64 bits\",\n    \"4-1\": \"SQLi, RCE, FileIO, Redirect, XSS\",\n    \"5-1\": \"MSSQL (via System.Data.SqlClient)\",\n    \"6-0\": \"Templating engine\",\n    \"6-1\": \"C# Razor templates (.cshtml)\",\n    \"7-0\": \"Tuning\",\n    \"7-1\": \"Requires ASP.NET MVC\"\n  },\n  \"cols\": 2,\n  \"rows\": 8\n}\n[/block]\n\n[block:api-header]\n{\n  \"title\": \"Prerequisites\"\n}\n[/block]\nThe IMMUNIO agent communicates with a management service at https://agent.immun.io. Ensure outbound access to this address is unblocked.​\n\n[block:api-header]\n{\n  \"title\": \"Installation\"\n}\n[/block]\nThe .NET Agent comes packaged in a compressed file (.ZIP) and includes an installer. The installer ensures the Agent files are included in the right location for your application.\n\nSteps for installing and enabling the agent on IIS:\n\n1. Download the latest ZIP package [from this link](http://download.immun.io/NET/Immunio-1.1.0.zip).\n2. Uncompress the ZIP file and run *install.bat*\n3. Add your Immunio key and secret and configure the agent in *C:\\Program Files\\Immunio\\Immunio.config* (as an Administrator)\n4. Restart IIS (*iisreset /noforce*)\n[block:api-header]\n{\n  \"title\": \"Upgrading\"\n}\n[/block]\nIf you have a previous version of Immunio installed, uninstall it first before installing the new version:\n\n1. Run C:\\Program Files\\Immunio\\uninstall.bat\n2. Restart your computer\n3. Install the new version, following the steps above\n[block:api-header]\n{\n  \"title\": \"Account Take Over Protection with Immunio\"\n}\n[/block]\nIf you are using *System.Web.Security.Membership* to handle authentication, Account Takeover Protection is activated upon installation.\n\nTo enable Immunio's Account Takeover Protection on other or custom authentication systems, add a reference to C:\\Program Files\\Immunio\\bin\\net452\\Immunio.dll, and use the Authentication API. Refer to the [.NET Agent API section](/docs/net-agent-api).\n[block:api-header]\n{\n  \"title\": \"Verification\"\n}\n[/block]\nOnce the agent is installed and configured, start your application and send an HTTP request to it. It's possible the agent status displays INACTIVE in the dashboard, prior to the first HTTP request to be sent to the application. However, shortly after the first request was sent, the agent should report in and change its status indicator to OK. Your app is now protected with IMMUNIO!​","excerpt":"","slug":"net","type":"basic","title":".NET"}
[block:image] { "images": [ { "image": [ "https://files.readme.io/531663f-microsoft_.net_.png", "microsoft_.net_.png", 200, 200, "#0f87c3" ] } ] } [/block] [block:api-header] { "title": "Supported Versions" } [/block] [block:parameters] { "data": { "h-0": "", "h-1": ".NET Framework", "h-2": ".NET Framework", "0-0": ".NET Framework version", "0-1": "4.5.2 and above", "0-2": "4.5.2 and above", "1-0": "Operating Systems", "1-1": "Windows Server 2008 Service Pack 2 and up", "1-2": "Windows", "3-0": "Account Protection", "3-1": "Through instrumentation of [System.Web.Security.Membership](https://msdn.microsoft.com/en-us/library/system.web.security.membership.aspx) as well as Immunio Authentication API", "3-2": "Through instrumentation of [System.Web.Security.Membership](https://msdn.microsoft.com/en-us/library/system.web.security.membership.aspx) as well as Immunio Authentication API,", "4-0": "Code Protection", "4-2": "SQLi, RCE, FileIO, Redirect, XSS", "5-0": "SQL Database", "5-2": "MSSQL", "2-0": "Architecture", "2-1": "64 bits", "2-2": "64 bits", "4-1": "SQLi, RCE, FileIO, Redirect, XSS", "5-1": "MSSQL (via System.Data.SqlClient)", "6-0": "Templating engine", "6-1": "C# Razor templates (.cshtml)", "7-0": "Tuning", "7-1": "Requires ASP.NET MVC" }, "cols": 2, "rows": 8 } [/block] [block:api-header] { "title": "Prerequisites" } [/block] The IMMUNIO agent communicates with a management service at https://agent.immun.io. Ensure outbound access to this address is unblocked.​ [block:api-header] { "title": "Installation" } [/block] The .NET Agent comes packaged in a compressed file (.ZIP) and includes an installer. The installer ensures the Agent files are included in the right location for your application. Steps for installing and enabling the agent on IIS: 1. Download the latest ZIP package [from this link](http://download.immun.io/NET/Immunio-1.1.0.zip). 2. Uncompress the ZIP file and run *install.bat* 3. Add your Immunio key and secret and configure the agent in *C:\Program Files\Immunio\Immunio.config* (as an Administrator) 4. Restart IIS (*iisreset /noforce*) [block:api-header] { "title": "Upgrading" } [/block] If you have a previous version of Immunio installed, uninstall it first before installing the new version: 1. Run C:\Program Files\Immunio\uninstall.bat 2. Restart your computer 3. Install the new version, following the steps above [block:api-header] { "title": "Account Take Over Protection with Immunio" } [/block] If you are using *System.Web.Security.Membership* to handle authentication, Account Takeover Protection is activated upon installation. To enable Immunio's Account Takeover Protection on other or custom authentication systems, add a reference to C:\Program Files\Immunio\bin\net452\Immunio.dll, and use the Authentication API. Refer to the [.NET Agent API section](/docs/net-agent-api). [block:api-header] { "title": "Verification" } [/block] Once the agent is installed and configured, start your application and send an HTTP request to it. It's possible the agent status displays INACTIVE in the dashboard, prior to the first HTTP request to be sent to the application. However, shortly after the first request was sent, the agent should report in and change its status indicator to OK. Your app is now protected with IMMUNIO!​