git-secret-protector 1.2.1__tar.gz → 1.2.2__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (26) hide show
  1. {git_secret_protector-1.2.1 → git_secret_protector-1.2.2}/PKG-INFO +63 -3
  2. {git_secret_protector-1.2.1 → git_secret_protector-1.2.2}/README.md +62 -2
  3. {git_secret_protector-1.2.1 → git_secret_protector-1.2.2}/pyproject.toml +1 -1
  4. {git_secret_protector-1.2.1 → git_secret_protector-1.2.2}/src/git_secret_protector/__init__.py +0 -0
  5. {git_secret_protector-1.2.1 → git_secret_protector-1.2.2}/src/git_secret_protector/context/__init__.py +0 -0
  6. {git_secret_protector-1.2.1 → git_secret_protector-1.2.2}/src/git_secret_protector/context/module.py +0 -0
  7. {git_secret_protector-1.2.1 → git_secret_protector-1.2.2}/src/git_secret_protector/core/__init__.py +0 -0
  8. {git_secret_protector-1.2.1 → git_secret_protector-1.2.2}/src/git_secret_protector/core/git_attributes_parser.py +0 -0
  9. {git_secret_protector-1.2.1 → git_secret_protector-1.2.2}/src/git_secret_protector/core/settings.py +0 -0
  10. {git_secret_protector-1.2.1 → git_secret_protector-1.2.2}/src/git_secret_protector/crypto/__init__.py +0 -0
  11. {git_secret_protector-1.2.1 → git_secret_protector-1.2.2}/src/git_secret_protector/crypto/aes_encryption_handler.py +0 -0
  12. {git_secret_protector-1.2.1 → git_secret_protector-1.2.2}/src/git_secret_protector/crypto/aes_key_manager.py +0 -0
  13. {git_secret_protector-1.2.1 → git_secret_protector-1.2.2}/src/git_secret_protector/error/aes_key_error.py +0 -0
  14. {git_secret_protector-1.2.1 → git_secret_protector-1.2.2}/src/git_secret_protector/error/storage_error.py +0 -0
  15. {git_secret_protector-1.2.1 → git_secret_protector-1.2.2}/src/git_secret_protector/main.py +0 -0
  16. {git_secret_protector-1.2.1 → git_secret_protector-1.2.2}/src/git_secret_protector/services/__init__.py +0 -0
  17. {git_secret_protector-1.2.1 → git_secret_protector-1.2.2}/src/git_secret_protector/services/encryption_manager.py +0 -0
  18. {git_secret_protector-1.2.1 → git_secret_protector-1.2.2}/src/git_secret_protector/services/key_rotator.py +0 -0
  19. {git_secret_protector-1.2.1 → git_secret_protector-1.2.2}/src/git_secret_protector/storage/__init__.py +0 -0
  20. {git_secret_protector-1.2.1 → git_secret_protector-1.2.2}/src/git_secret_protector/storage/aws_ssm_storage_manager.py +0 -0
  21. {git_secret_protector-1.2.1 → git_secret_protector-1.2.2}/src/git_secret_protector/storage/gcp_secret_storage_manager.py +0 -0
  22. {git_secret_protector-1.2.1 → git_secret_protector-1.2.2}/src/git_secret_protector/storage/storage_manager_factory.py +0 -0
  23. {git_secret_protector-1.2.1 → git_secret_protector-1.2.2}/src/git_secret_protector/storage/storage_manager_interface.py +0 -0
  24. {git_secret_protector-1.2.1 → git_secret_protector-1.2.2}/src/git_secret_protector/utils/__init__.py +0 -0
  25. {git_secret_protector-1.2.1 → git_secret_protector-1.2.2}/src/git_secret_protector/utils/configure_logging.py +0 -0
  26. {git_secret_protector-1.2.1 → git_secret_protector-1.2.2}/src/git_secret_protector/utils/project_version.py +0 -0
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.1
2
2
  Name: git-secret-protector
3
- Version: 1.2.1
3
+ Version: 1.2.2
4
4
  Summary: A tool for managing secrets in Git with AWS Parameter Store integration.
5
5
  Author: Duc Duong
6
6
  Author-email: duc.duong@c0x12c.com
@@ -201,7 +201,67 @@ Logs are stored in the `logs/` directory by default, and you can configure the l
201
201
 
202
202
  See [CHANGELOG.md](CHANGELOG.md) for a history of changes and updates.
203
203
 
204
- ## Support
204
+ ## Troubleshooting
205
205
 
206
- If you encounter any issues or have any questions, please open an issue on the GitHub repository or reach out to our support team.
206
+ If you encounter any issues while using the `git-secret-protector` tool, try the following tips and solutions:
207
+
208
+ ### Common Issues
209
+
210
+ #### 1. Filter Configuration Issues
211
+
212
+ If the filters are not configured correctly, you might encounter errors when encrypting or decrypting files.
213
+
214
+ **Solution**:
215
+ Re-setup the filters based on your `.gitattributes` file.
216
+
217
+ ```sh
218
+ git-secret-protector setup-filters
219
+ ```
220
+
221
+ #### 2. Missing or Incorrect AES Key
222
+
223
+ If you fail to encrypt or decrypt files due to a missing or incorrect AES key, you will need to ensure that the keys are
224
+ correctly fetched from the Cloud Secret Storage Service.
225
+
226
+ **Solution**:
227
+ Pull the latest AES keys from the Cloud Secret Storage Service for the relevant filters.
228
+
229
+ ```sh
230
+ git-secret-protector pull-aes-key <filter_name>
231
+ ```
232
+
233
+ #### 3. Permissions Issues
234
+
235
+ Lack of necessary permissions can result in errors while accessing Cloud Secret Storage Services.
236
+
237
+ **Solution**:
238
+ Ensure that you have the required permissions to manage resources in your Cloud Secret Storage Service.
239
+
240
+ ### Example Issue: File Decryption Failure
241
+
242
+ **Issue**:
243
+ You receive an error when trying to decrypt files using the `decrypt-files` command.
244
+
245
+ **Solution**:
246
+
247
+ 1. Ensure that you have pulled the latest AES keys:
248
+
249
+ ```sh
250
+ git-secret-protector pull-aes-key <filter_name>
251
+ ```
252
+
253
+ 2. Check if the filters are correctly set up:
254
+
255
+ ```sh
256
+ git-secret-protector setup-filters
257
+ ```
258
+
259
+ 3. Attempt to decrypt the files again:
260
+
261
+ ```sh
262
+ git-secret-protector decrypt-files <filter_name>
263
+ ```
264
+
265
+ If the issue persists, verify your configurations in the `config.ini` file, and consult the logs located in the `logs/`
266
+ directory for more detailed error information.
207
267
 
@@ -182,6 +182,66 @@ Logs are stored in the `logs/` directory by default, and you can configure the l
182
182
 
183
183
  See [CHANGELOG.md](CHANGELOG.md) for a history of changes and updates.
184
184
 
185
- ## Support
185
+ ## Troubleshooting
186
186
 
187
- If you encounter any issues or have any questions, please open an issue on the GitHub repository or reach out to our support team.
187
+ If you encounter any issues while using the `git-secret-protector` tool, try the following tips and solutions:
188
+
189
+ ### Common Issues
190
+
191
+ #### 1. Filter Configuration Issues
192
+
193
+ If the filters are not configured correctly, you might encounter errors when encrypting or decrypting files.
194
+
195
+ **Solution**:
196
+ Re-setup the filters based on your `.gitattributes` file.
197
+
198
+ ```sh
199
+ git-secret-protector setup-filters
200
+ ```
201
+
202
+ #### 2. Missing or Incorrect AES Key
203
+
204
+ If you fail to encrypt or decrypt files due to a missing or incorrect AES key, you will need to ensure that the keys are
205
+ correctly fetched from the Cloud Secret Storage Service.
206
+
207
+ **Solution**:
208
+ Pull the latest AES keys from the Cloud Secret Storage Service for the relevant filters.
209
+
210
+ ```sh
211
+ git-secret-protector pull-aes-key <filter_name>
212
+ ```
213
+
214
+ #### 3. Permissions Issues
215
+
216
+ Lack of necessary permissions can result in errors while accessing Cloud Secret Storage Services.
217
+
218
+ **Solution**:
219
+ Ensure that you have the required permissions to manage resources in your Cloud Secret Storage Service.
220
+
221
+ ### Example Issue: File Decryption Failure
222
+
223
+ **Issue**:
224
+ You receive an error when trying to decrypt files using the `decrypt-files` command.
225
+
226
+ **Solution**:
227
+
228
+ 1. Ensure that you have pulled the latest AES keys:
229
+
230
+ ```sh
231
+ git-secret-protector pull-aes-key <filter_name>
232
+ ```
233
+
234
+ 2. Check if the filters are correctly set up:
235
+
236
+ ```sh
237
+ git-secret-protector setup-filters
238
+ ```
239
+
240
+ 3. Attempt to decrypt the files again:
241
+
242
+ ```sh
243
+ git-secret-protector decrypt-files <filter_name>
244
+ ```
245
+
246
+ If the issue persists, verify your configurations in the `config.ini` file, and consult the logs located in the `logs/`
247
+ directory for more detailed error information.
@@ -1,6 +1,6 @@
1
1
  [tool.poetry]
2
2
  name = "git-secret-protector"
3
- version = "1.2.1"
3
+ version = "1.2.2"
4
4
  description = "A tool for managing secrets in Git with AWS Parameter Store integration."
5
5
  authors = ["Duc Duong <duc.duong@c0x12c.com>"]
6
6
  readme = "README.md"