{"id":23122601,"url":"https://github.com/folio-org/mod-finance-storage","last_synced_at":"2026-02-17T16:00:32.771Z","repository":{"id":37730490,"uuid":"113095475","full_name":"folio-org/mod-finance-storage","owner":"folio-org","description":"CRUD module to manage finance-data (i.e. ledgers, funds, budgets, etc.)","archived":false,"fork":false,"pushed_at":"2026-02-16T16:45:34.000Z","size":2060,"stargazers_count":2,"open_issues_count":3,"forks_count":6,"subscribers_count":12,"default_branch":"master","last_synced_at":"2026-02-16T19:44:41.826Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Java","has_issues":false,"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/folio-org.png","metadata":{"files":{"readme":"README.md","changelog":"NEWS.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":"CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2017-12-04T21:10:42.000Z","updated_at":"2026-02-04T17:52:41.000Z","dependencies_parsed_at":"2023-02-18T07:31:05.557Z","dependency_job_id":"c5d1e4a4-ae08-4e83-8574-d4a92797da10","html_url":"https://github.com/folio-org/mod-finance-storage","commit_stats":null,"previous_names":[],"tags_count":68,"template":false,"template_full_name":null,"purl":"pkg:github/folio-org/mod-finance-storage","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/folio-org%2Fmod-finance-storage","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/folio-org%2Fmod-finance-storage/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/folio-org%2Fmod-finance-storage/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/folio-org%2Fmod-finance-storage/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/folio-org","download_url":"https://codeload.github.com/folio-org/mod-finance-storage/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/folio-org%2Fmod-finance-storage/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29549200,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-17T14:33:00.708Z","status":"ssl_error","status_checked_at":"2026-02-17T14:32:58.657Z","response_time":100,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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-12-17T07:28:31.631Z","updated_at":"2026-02-17T16:00:32.763Z","avatar_url":"https://github.com/folio-org.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# mod-finance-storage\n\nCopyright (C) 2017-2023 The Open Library Foundation\n\nThis software is distributed under the terms of the Apache License, Version 2.0. See the file \"[LICENSE](LICENSE)\" for more information.\n\n## Introduction\n\nThis RMB-module is responsible for the persistence of finance-related data (i.e. funds, ledgers, transactions, etc.)\n\nFor additional information regarding this module, please refer to the [Finance Module WIKI](https://wiki.folio.org/display/RM/Acquisitions+Fund+Module).\n\n\n## Building the Project\n\nTo compile this module, head to the root-folder and run the following command in your Terminal:\n\n```\nmvn clean install\n```\n\nTo run the module in standalone mode (i.e. without involving Okapi):\n```\nDB_HOST=localhost DB_PORT=5432 DB_USERNAME=myuser DB_PASSWORD=mypass DB_DATABASE=mydb \\\n java -jar target/mod-finance-fat.jar -Dhttp.port=8081\n```\n\n## Issue tracker\n\nSee project [MODFISTO](https://issues.folio.org/browse/MODFISTO)\nat the [FOLIO issue tracker](https://dev.folio.org/guidelines/issue-tracker).\n\n## ModuleDescriptor\n\nSee the [ModuleDescriptor](descriptors/ModuleDescriptor-template.json)\nfor the interfaces that this module requires and provides, the permissions,\nand the additional module metadata.\n\n## API Documentation\n\nGenerated [API documentation](https://dev.folio.org/reference/api/#mod-finance-storage).\n\n### Secure storage environment variables\n\n#### AWS-SSM\n\nRequired when `SECRET_STORE_TYPE=AWS_SSM`\n\n| Name                                          | Default value | Description                                                                                                                                                    |\n|:----------------------------------------------|:--------------|:---------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| SECRET_STORE_AWS_SSM_REGION                   | -             | The AWS region to pass to the AWS SSM Client Builder. If not set, the AWS Default Region Provider Chain is used to determine which region to use.              |\n| SECRET_STORE_AWS_SSM_USE_IAM                  | true          | If true, will rely on the current IAM role for authorization instead of explicitly providing AWS credentials (access_key/secret_key)                           |\n| SECRET_STORE_AWS_SSM_ECS_CREDENTIALS_ENDPOINT | -             | The HTTP endpoint to use for retrieving AWS credentials. This is ignored if useIAM is true                                                                     |\n| SECRET_STORE_AWS_SSM_ECS_CREDENTIALS_PATH     | -             | The path component of the credentials endpoint URI. This value is appended to the credentials endpoint to form the URI from which credentials can be obtained. |\n\n#### Vault\n\nRequired when `SECRET_STORE_STORE_TYPE=VAULT`\n\n| Name                                    | Default value | Description                                                                         |\n|:----------------------------------------|:--------------|:------------------------------------------------------------------------------------|\n| SECRET_STORE_VAULT_TOKEN                | -             | token for accessing vault, may be a root token                                      |\n| SECRET_STORE_VAULT_ADDRESS              | -             | the address of your vault                                                           |\n| SECRET_STORE_VAULT_ENABLE_SSL           | false         | whether or not to use SSL                                                           |\n| SECRET_STORE_VAULT_PEM_FILE_PATH        | -             | the path to an X.509 certificate in unencrypted PEM format, using UTF-8 encoding    |\n| SECRET_STORE_VAULT_KEYSTORE_PASSWORD    | -             | the password used to access the JKS keystore (optional)                             |\n| SECRET_STORE_VAULT_KEYSTORE_FILE_PATH   | -             | the path to a JKS keystore file containing a client cert and private key            |\n| SECRET_STORE_VAULT_TRUSTSTORE_FILE_PATH | -             | the path to a JKS truststore file containing Vault server certs that can be trusted |\n\n#### FSSP (Folio Secure Store Proxy)\n\nRequired when `SECRET_STORE_TYPE=FSSP`\n\n| Name                                     | Default value         | Description                                         |\n|:-----------------------------------------|:----------------------|:----------------------------------------------------|\n| SECRET_STORE_FSSP_ADDRESS                | -                     | The address (URL) of the FSSP service.              |\n| SECRET_STORE_FSSP_SECRET_PATH            | secure-store/entries  | The path in FSSP where secrets are stored.          |\n| SECRET_STORE_FSSP_KEYSTORE_PATH          | -                     | The path to the key store file.                     |\n| SECRET_STORE_FSSP_KEYSTORE_FILE_TYPE     | jks                   | The type of the key store file (e.g., \"jks\", \"pem\") |\n| SECRET_STORE_FSSP_KEYSTORE_PASSWORD      | -                     | The password for the key store file.                |\n| SECRET_STORE_FSSP_TRUSTSTORE_PATH        | -                     | The path to the trust store file.                   |\n| SECRET_STORE_FSSP_TRUSTSTORE_FILE_TYPE   | jks                   | Truststore file type (e.g., JKS, PKCS12).           |\n| SECRET_STORE_FSSP_TRUSTSTORE_PASSWORD    | -                     | Truststore password for SSL connections.            |\n\n## Code analysis\n\n[SonarQube analysis](https://sonarcloud.io/dashboard?id=org.folio%3Amod-finance-storage).\n\n## Download and configuration\n\nThe built artifacts for this module are available.\nSee [configuration](https://dev.folio.org/download/artifacts) for repository access,\nand the [Docker image](https://hub.docker.com/r/folioorg/mod-finance-storage/).\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffolio-org%2Fmod-finance-storage","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffolio-org%2Fmod-finance-storage","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffolio-org%2Fmod-finance-storage/lists"}