{"id":23318081,"url":"https://github.com/softwareag/webmethods-integrationserver-wxpassword","last_synced_at":"2025-04-07T04:53:27.002Z","repository":{"id":81495215,"uuid":"377165275","full_name":"SoftwareAG/webmethods-integrationserver-wxpassword","owner":"SoftwareAG","description":"Ensure non-default passwords for Integration Server standard users","archived":false,"fork":false,"pushed_at":"2021-06-16T16:15:55.000Z","size":22,"stargazers_count":2,"open_issues_count":2,"forks_count":2,"subscribers_count":4,"default_branch":"main","last_synced_at":"2025-02-13T09:29:18.752Z","etag":null,"topics":["global-presales","integration-server","webmethods"],"latest_commit_sha":null,"homepage":"","language":"Java","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/SoftwareAG.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}},"created_at":"2021-06-15T13:04:25.000Z","updated_at":"2024-02-20T21:33:41.000Z","dependencies_parsed_at":"2023-06-25T22:54:53.037Z","dependency_job_id":null,"html_url":"https://github.com/SoftwareAG/webmethods-integrationserver-wxpassword","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SoftwareAG%2Fwebmethods-integrationserver-wxpassword","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SoftwareAG%2Fwebmethods-integrationserver-wxpassword/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SoftwareAG%2Fwebmethods-integrationserver-wxpassword/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SoftwareAG%2Fwebmethods-integrationserver-wxpassword/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/SoftwareAG","download_url":"https://codeload.github.com/SoftwareAG/webmethods-integrationserver-wxpassword/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247595373,"owners_count":20963943,"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":["global-presales","integration-server","webmethods"],"created_at":"2024-12-20T17:15:25.988Z","updated_at":"2025-04-07T04:53:26.966Z","avatar_url":"https://github.com/SoftwareAG.png","language":"Java","readme":"# WxPassword\n\nInitial functionality is to change the passwords of the built-in users of\nwebMethods Integration Server\n(Administrator, Replicator, Developer). The primary use-case is deployment \nin a container.\n\n## Usage\n\nTo enable the automated update of passwords the environment variable\n`SAG_WXPASSWORD_UPDATE_DEFAULT_ACCOUNTS` must be set to `true`.\nThis mechanism protects against accidental execution and by that\na potential lock-out.\n\n\n### Specific passwords\n\nIn a typical production deployment, the desired passwords need to\nbe provide as environment variables. The naming convention is\n`SAG_WXPASSWORD_SET_\u003cUSERNAME\u003e`. So for the `Administrator` account \nthe variable `SAG_WXPASSWORD_SET_Administrator` must be defined.\n\n### Random passwords\n\nIf no password is defined via environment variable, a random one will \nbe generated and saved in clear text in the working directory. For \neach user a separate file will be created and its name matches the user name.\n\n**Intended only for\nnon-production environments!**\n\n### Working directory\n\nThe working directory needs to be provided as an environment variable\n(`SAG_WXPASSWORD_DIR`). If nothing is specified, the fall-back value\nis `$IS_HOME/config/WxPassword`. In both cases, the directory will\nbe created, if it does not exist. If the creation fails, a\n`ServiceException` is thrown and now further activities performed.\n\n## Getting Started\n\nYou can use this package in multiple ways.\n\n1. Simply make use of the existing functionality\n1. Use it as a source of inspiration for your own development\n1. Contribute to WxPassword by adding new functionality and/or fixing bugs\n\n### Installing a Release\n\nThis is the suitable approach, if you either just want to use WxPassword or use it as a starting point for\nyour own development.\n\n* Download `WxPassword.zip` from the [latest release](https://github.com/SoftwareAG/webmethods-integrationserver-wxpassword/releases), place it into `$IS_HOME/replicate/inbound/`, and install via \"Packages / Management / Install Inbound Releases\"\n  \n### Installation from Source\n\n- Prerequisite: You need \"Local Service Development\" installed (located in Designer preferences at  \"Software AG / Service Development / Local Service Development\")\n- Get sources\n  - Via Software AG Designer (no separate Git installation needed)\n    - Open \"Java\" perspective\n\t- Click \"Import projects\"\n\t- Select \"Git / Projects from Git\"\n\t- Select \"Clone URI\"\n\t- Paste Git URI from green \"Clone or download\" button above\n\t- Adjust target directory to `\u003cWORKSPACE\u003e/WxPassword`\n\t- Confirm defaults on all further dialogues and finish the import\n  - Via command line (requires local Git installation)\n    - Go into Designer workspace (e.g. `/home/john/workspace105`)\n    - Clone Git repository into new directory `git clone https://github.com/SoftwareAG/webmethods-integrationserver-wxpassword.git WxPassword`\n\t- Import as existing project into workspace\n- Activate package in Integration Server\n\t- If the \"Service Development\" perspective has not been active before you openend the \"Java\" perspective, you must quickly switch there and then directly back to \"Java\". This is needed to initialize the Local Service Development feature.\n\t- In the \"Java\" perspective right-click the project name and select \"Move Project to IS Package\"\n\t- Switch to the \"Service Development\" perspective and the WxPassword package should show up\n- Compile and frag package (required because for Java services neither the class files nor the frag files are versioned)\n  - Open Command Promopt (`cmd.exe`) and go into `$IS_HOME/bin`\tdirectory\n  - Execute the following commands\n    ```\n    jcode makeall WxPassword\n    jcode fragall WxPassword\n    ```\n\n\n------------------------------\n\nThese tools are provided as-is and without warranty or support. They do not constitute part of the Software AG product suite. Users are free to use, fork and modify them, subject to the license agreement. While Software AG welcomes contributions, we cannot guarantee to include every contribution in the master project.\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsoftwareag%2Fwebmethods-integrationserver-wxpassword","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsoftwareag%2Fwebmethods-integrationserver-wxpassword","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsoftwareag%2Fwebmethods-integrationserver-wxpassword/lists"}