README.md

-## Coscine STS
-
-Instructions for making it run:
-
-* Set the value "coscine/local/api/additional/url" in your Consul storage to your Api url
-* Set the value "coscine/global/sts/pfx" in your Consul storage to your certificate pfx file content
-* Set the value "coscine/global/sts/pfxpassword" in your Consul storage to your certificate password
-* Run the Coscine STS
-* Run "src/deploySTS.ps1"
-	* Requirements
-		* Consul installed
-		* Existing Consul key "traefik/entrypoints/https/tls/certificates/0/certFile" with the certificate file content
-	* Input your SharePoint WebApplication
-	* Input your Coscine STS site (Url is automatically generated and you can find it under "coscine/global/sts/url")
-* Visit your SharePoint and put in your User Guid
-	* You find one from your Coscine database
-	* You should be logged in with that User Guid
-* Set the value "coscine/global/ad/url" in your Consul storage with your Active Directory url
-* Set the value "coscine/global/ad/ou" in your Consul storage with your Active Directory orginizational unit
-* Set the value "coscine/global/ad/username" in your Consul storage with your Active Directory username
-* Set the value "coscine/global/ad/password" in your Consul storage with your Active Directory password
-* Have fun!
-
-For ORCiD:
-
-* Set the values for "coscine/global/orcid/url", "coscine/global/orcid/clientid", "coscine/global/orcid/jwksurl" and "coscine/global/orcid/issuer". 
-
-For Shibboleth:
-
-* Set the values for "coscine/global/shibboleth/url", "coscine/global/shibboleth/metadata" and "coscine/global/shibboleth/contact".
-
-### Links 
-
-*  [Commit convention](docs/ESLintConvention.md)
-*  [Everything possible with markup](docs/testdoc.md)
-*  [Adding NUnit tests](docs/nunit.md)
\ No newline at end of file
+# STS API
+
+[[_TOC_]] 
+
+## 📝 Overview
+
+The STS (Security Token Service) API is a REST API that provides the functionality of a login service for the Coscine platform. With this API, you can manage external user authentication and access control using ORCID and Shibboleth logins.
+
+## ⚙️ Configuration
+
+Before you can run and use the API, you need to ensure that the following dependencies and prerequisites are in place:
+
+1. A Coscine database instance must be running. If you haven't set up a Coscine database instance yet, please refer to the [Coscine documentation]() for instructions on how to do so.
+2. The Consul service should be correctly set up as a Key-Value store. If you haven't set up Consul yet, please refer to the [Consul documentation]() for instructions on how to do so.
+3. The project's referenced .NET SDK(s) must be installed. Please refer to the project's source code for information on which .NET SDK(s) are required.
+
+Once you have all the necessary dependencies and prerequisites in place, you should be able to run and use the API with the appropriate authentication credentials.
+
+## 📚 API Reference
+
+To get started with this project, you will need to ensure you have configured it correctly. Please refer to the configuration guide above. Once the project is running, you can access the API through the following Swagger endpoint:
+```xml
+<root>/coscine/api/Coscine.Api.STS/swagger/index.html
+```
+
+To authenticate in Swagger with a Bearer JWT token, you will need to generate a token in Coscine under your _User Profile_. Once you have your token, you can open the Swagger documentation for the API you want to authenticate with and click on the "Authorize" button. In the "Authorization Value" field, you should enter `Bearer` followed by a space and then your Bearer JWT token. Click on the "Authorize" button to authenticate, and you should now be able to make authenticated requests to the API. 
+> :bulb: Make sure to keep your Bearer JWT token secure, as it grants access to your account and API resources. If you suspect that your token has been compromised, you should generate a new one and invalidate all existing ones immediately.
+
+For detailed information about each endpoint and the parameters they accept, please refer to the [API Swagger documentation](https://coscine.rwth-aachen.de/coscine/api/Coscine.Api.STS/swagger/index.html).
+
+## 👥 Contributing
+
+As an open source plattform and project, we welcome contributions from our community in any form. You can do so by submitting bug reports or feature requests, or by directly contributing to Coscine's source code. To submit your contribution please follow our [Contributing Guideline](https://git.rwth-aachen.de/coscine/docs/public/wiki/-/blob/master/Contributing%20To%20Coscine.md).
+
+## 📄 License
+
+The current open source repository is licensed under the **MIT License**, which is a permissive license that allows the software to be used, modified, and distributed for both commercial and non-commercial purposes, with limited restrictions (see `LICENSE` file)
+
+> The MIT License allows for free use, modification, and distribution of the software and its associated documentation, subject to certain conditions. The license requires that the copyright notice and permission notice be included in all copies or substantial portions of the software. The software is provided "as is" without any warranties, and the authors or copyright holders cannot be held liable for any damages or other liability arising from its use.
+
+## 🆘 Support
+
+1. **Check the documentation**: Before reaching out for support, check the help pages provided by the team at https://docs.coscine.de/en/. This may have the information you need to solve the issue.
+2. **Contact the team**: If the documentation does not help you or if you have a specific question, you can reach out to our support team at `servicedesk@itc.rwth-aachen.de` 📧. Provide a detailed description of the issue you're facing, including any error messages or screenshots if applicable.
+3. **Be patient**: Our team will do their best to provide you with the support you need, but keep in mind that they may have a lot of requests to handle. Be patient and wait for their response.
+4. **Provide feedback**: If the support provided by our support team helps you solve the issue, let us know! This will help us improve our documentation and support processes for future users.
+
+By following these simple steps, you can get the support you need to use Coscine's services as an external user.
+
+## 📦 Release & Changelog
+
+External users can find the _Releases and Changelog_ inside each project's repository. The repository contains a section for Releases (`Deployments > Releases`), where users can find the latest release changelog and source. Withing the Changelog you can find a list of all the changes made in that particular release and version.  
+By regularly checking for new releases and changes in the Changelog, you can stay up-to-date with the latest improvements and bug fixes by our team and community!

src/STS/STS.csproj

@@ -6,7 +6,7 @@
 		<GenerateDocumentationFile>true</GenerateDocumentationFile>
 		<TargetFramework>net6.0</TargetFramework>
 		<GenerateAssemblyInfo>false</GenerateAssemblyInfo>
-		<Version>4.0.3</Version>
+		<Version>4.0.4</Version>
 	</PropertyGroup>
 	<PropertyGroup>
 		<Authors>RWTH Aachen University</Authors>