{"id":15221669,"url":"https://github.com/googlecloudplatform/alloydb-java-connector","last_synced_at":"2025-10-20T00:32:45.434Z","repository":{"id":181062919,"uuid":"626135758","full_name":"GoogleCloudPlatform/alloydb-java-connector","owner":"GoogleCloudPlatform","description":"A Java library for connecting securely to your AlloyDB instances.","archived":false,"fork":false,"pushed_at":"2024-12-10T20:50:24.000Z","size":911,"stargazers_count":13,"open_issues_count":7,"forks_count":7,"subscribers_count":23,"default_branch":"main","last_synced_at":"2024-12-18T08:39:18.273Z","etag":null,"topics":["alloydb","java","socket-factory"],"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/GoogleCloudPlatform.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-04-10T21:49:23.000Z","updated_at":"2024-12-10T20:50:27.000Z","dependencies_parsed_at":"2023-09-26T00:32:07.702Z","dependency_job_id":"e7869740-2a87-4082-bf5a-cc8e3daae881","html_url":"https://github.com/GoogleCloudPlatform/alloydb-java-connector","commit_stats":{"total_commits":305,"total_committers":8,"mean_commits":38.125,"dds":"0.45245901639344266","last_synced_commit":"6969ec321206be9855adc926d9f35e44c5dbca66"},"previous_names":["googlecloudplatform/alloydb-java-connector"],"tags_count":18,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GoogleCloudPlatform%2Falloydb-java-connector","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GoogleCloudPlatform%2Falloydb-java-connector/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GoogleCloudPlatform%2Falloydb-java-connector/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GoogleCloudPlatform%2Falloydb-java-connector/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/GoogleCloudPlatform","download_url":"https://codeload.github.com/GoogleCloudPlatform/alloydb-java-connector/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":237236958,"owners_count":19277082,"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":["alloydb","java","socket-factory"],"created_at":"2024-09-28T15:06:41.334Z","updated_at":"2025-10-20T00:32:45.428Z","avatar_url":"https://github.com/GoogleCloudPlatform.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# AlloyDB Java Connector\n\n[![CI][ci-badge]][ci-build]\n[![Maven][maven-version-image]][maven-version-link]\n\n[ci-badge]: https://github.com/GoogleCloudPlatform/alloydb-java-connector/actions/workflows/ci.yaml/badge.svg?event=push\n[ci-build]: https://github.com/GoogleCloudPlatform/alloydb-java-connector/actions/workflows/ci.yaml?query=event%3Apush+branch%3Amain\n[maven-version-image]: https://img.shields.io/maven-central/v/com.google.cloud/alloydb-jdbc-connector.svg\n[maven-version-link]: https://central.sonatype.com/artifact/com.google.cloud/alloydb-jdbc-connector/\n\n- [Product Documentation](https://cloud.google.com/alloydb/docs)\n\nThe _AlloyDB Java Connector_ is a Java library for connecting securely to your\nAlloyDB instances. Using a Connector provides the following benefits:\n\n* **IAM Authorization:** The Connector uses IAM to ensure only principals with valid\n  permissions are allowed to connect.\n* **Improved Security:** The Connector uses TLS 1.3 encryption and\n  identity verification between the client connector and the server-side proxy,\n  independent of the database protocol.\n* **Convenience:** The Connector removes the requirement to use and distribute SSL\n  certificates.\n\n## Usage\n\nThis library provides a [socket factory][socket-factory] for use with the\n[JDBC Postgres Driver][postgres-driver]. At a high level, you will need to:\n\n1. Configure IAM permissions\n1. Add the Connector and Postgres driver as dependencies\n1. Configure a connection pool that configures the driver to use the Connector\n   as a socket factory\n\nFor information on configuring a connection, see the [documentation][jdbc-doc].\n\nIf you're using Spring Boot, consider using the [Spring Boot AlloyDB starter][spring-boot].\n\n[socket-factory]: https://docs.oracle.com/javase/8/docs/api/javax/net/SocketFactory.html\n[postgres-driver]: https://jdbc.postgresql.org/\n[jdbc-doc]: docs/jdbc.md\n[spring-boot]: https://googlecloudplatform.github.io/spring-cloud-gcp/5.3.0/reference/html/index.html#alloydb\n\n### Configuring IAM permissions\n\nThe Java Connector uses [Application Default Credentials (ADC)][adc]. For\ninformation on how to configure Application Default Credentials, see the\n[documentation][set-adc].\n\nIn addition, the associated IAM principal must have the IAM role \"Cloud AlloyDB\nClient\" (i.e., `roles/alloydb.client`). See the [docs on AlloyDB IAM permissions][iam-docs]\nfor more information.\n\n[adc]: https://cloud.google.com/docs/authentication/application-default-credentials\n[set-adc]: https://cloud.google.com/docs/authentication/provide-credentials-adc\n[iam-docs]: https://cloud.google.com/alloydb/docs/reference/iam-roles-permissions#roles\n\n### Debug Logging\n\nThe Java Connector supports optional debug logging to help diagnose problems with\nthe background certificate refresh. To enable it, add the following to the file\n`src/main/resources/application.yml`:\n\n```\nlogging.level.com.google.cloud.alloydb=DEBUG\n```\n\n## Support policy\n\n### Major version lifecycle\n\nThis project uses [semantic versioning](https://semver.org/), and uses the\nfollowing lifecycle regarding support for a major version:\n\n**Active** - Active versions get all new features and security fixes (that\nwould not otherwise introduce a breaking change). New major versions are\nguaranteed to be \"active\" for a minimum of 1 year.\n\n**Deprecated** - Deprecated versions continue to receive security and critical\nbug fixes, but do not receive new features. Deprecated versions will be\nsupported for 1 year.\n\n**Unsupported** - Any major version that has been deprecated for \u003e=1 year is\nconsidered unsupported.\n\n### Supported JDK versions\n\n\u003e Cloud Client Libraries for Java are compatible with, and tested against\n\u003e Java 8, Java 11, Java 17, and Java 21. Java 8 will continue to be supported\n\u003e by Cloud Client Libraries for Java until at least September 2026.\n\nSee [Supported Java Versions](https://cloud.google.com/java/docs/supported-java-versions).\n\n### Release cadence\n\nThis project aims for a minimum monthly release cadence. If no new\nfeatures or fixes have been added, a new PATCH version with the latest\ndependencies is released.\n\n## Versioning\n\nThis library follows [Semantic Versioning](http://semver.org/).\n\n## Contributing\n\nContributions to this library are always welcome and highly encouraged.\n\nSee [CONTRIBUTING][contributing] for more information how to get started.\n\n[contributing]: CONTRIBUTING.md\n\nPlease note that this project is released with a Contributor Code of Conduct. By participating in\nthis project you agree to abide by its terms. See [Code of Conduct][code-of-conduct] for more\ninformation.\n\n[code-of-conduct]: CODE_OF_CONDUCT.md\n\n## License\n\nApache 2.0 - See [LICENSE][license] for more information.\n\n[license]: LICENSE\n\n## Notice\n\nJava is a registered trademark of Oracle and/or its affiliates.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgooglecloudplatform%2Falloydb-java-connector","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgooglecloudplatform%2Falloydb-java-connector","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgooglecloudplatform%2Falloydb-java-connector/lists"}