Welcome to the WSO2 samples-is repository!

Sample IS is the repository where all samples related to WSO2 Identity Server are collected together.

Please follow below steps to add new projects to the repository.

1. Add your project folder to the root of the repository.
2. Make sure to use non-sensitive, general and self-descriptive names for artifact-id, packages and classes.
3. Please make sure the project is buildable without any modifications.
4. Add the project to Existing samples section with a single line description.
5. Add a complete readme file inside the project folder. Please use the below template.

README template

  ## <Project name>.
  ### Introduction / Use case.
  Please explain what your sample does and the use case. Use external links, images and diagrams if possible.
  
  ### Applicable product versions.
  List all WSO2 IS versions that can be used with this sample.
  
  ### How to use.
  Please provide detailed steps for using the sample. Include steps to building, patching, configurations that need to do, etc.
  
  ### Testing the project.
  Please provide steps for testing the sample. Provide example inputs and outputs as well.
  

Existing samples.

• Custom Carbon Log Appender by Vihanga Liyanage - A carbon log appender that can intercept and modify logs of WSO2 Identity Server.
• Custom Claim Handler by Nilasini Thirunavukkarasu - A custom claim handler that is capable of adding some external claims.
• Custom Permission Claim Handler by Nilasini Thirunavukkarasu - A custom claim handler that is capable of getting custom permissions along with the id token.
• Custom Password Generator by Nilasini Thirunavukkarasu - Ability to generate random passwords that satisfies your own password policies.
• Custom User Operation Event Listener by Nilasini Thirunavukkarasu - Ability to generate random passwords that satisfies your own password policies.
• Custom Scope Handler by Abilashini Thiyagarajah - A custom scope handler to remove the scopes which are not allowed from the token request and generate the access token with only the allowed scopes.
• Custom Email Module by Abhishek De Silva - A custom email module to send notification emails with HTML content for the WSO2 IS 5.3.0 and below.
• Custom Basic Authenticator for Force Password Reset via OTP by Dinali Dabarera - A custom basic authenticator which does force password reset via OTP.
• Custom Grant Type - BioMetric Grant by Vihanga Liyanage - A custom OAuth 2 grant type that can facilitate user authentication via biometric data.
• Custom PIP Attribute Finder by Vihanga Liyanage - A custom PIP attribute finder that can map external user roles to internal roles based on a provided map.
• Custom Remote User Store Manager by Tharindu Bandara - An aggregator module to consume a remote user database as a secondary user store.
• Custom Authentication Request Handler by Vimukthi Perera - Authenticator that will authorize the users based on their role to a targeted SAML based application.
• Custom Event Handler by Ishara Karunarathne - Subscribe to POST_AUTHENTICATION events and log the authenticated user name