Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/jangelmm/ito_tap_u2_componente_generatepassword

Last synced: about 2 months ago
JSON representation

Host: GitHub
URL: https://github.com/jangelmm/ito_tap_u2_componente_generatepassword
Owner: jangelmm
Created: 2024-04-20T21:42:08.000Z (9 months ago)
Default Branch: master
Last Pushed: 2024-04-30T04:53:57.000Z (9 months ago)
Last Synced: 2024-06-27T21:20:30.036Z (7 months ago)
Language: Java
Size: 6.3 MB
Stars: 1
Watchers: 1
Forks: 9
Open Issues: 0
Metadata Files:
- Readme: README.md

Awesome Lists containing this project

README

# Componente Generador de Contraseñas para Java

## Descripción
Este componente Java permite generar contraseñas seguras y aleatorias. Está diseñado para ser usado en aplicaciones Java Swing, pudiendo ser añadido fácilmente a `JFrame` o `JDialog`.

El componente desarrollado consta de dos clases principales, `SecurePasswordGenerator` y `GeneratePassword`, diseñadas para trabajar conjuntamente con el objetivo de generar contraseñas seguras y gestionar su interacción con el usuario a través de una interfaz gráfica.

## Usos
1. **Aplicaciones de Gestión de Usuarios**: El componente puede ser integrado en sistemas de gestión de usuarios donde se requiera la creación de contraseñas seguras para nuevos usuarios o para el reseteo de contraseñas existentes.
2. **Herramientas de Seguridad**: Podría ser utilizado como parte de una herramienta de seguridad más amplia que ofrezca funcionalidades como la gestión de contraseñas, auditorías de seguridad, o como un módulo en una suite de seguridad informática.
3. **Aplicaciones Web y Móviles**: Integración en aplicaciones web o móviles que requieran una alta seguridad en el manejo de contraseñas, como aplicaciones bancarias, comercio electrónico, o plataformas que manejen información sensible.
4. **Herramientas de Desarrollo de Software**: Como un plugin o extensión en entornos de desarrollo, ayudando a los desarrolladores a generar contraseñas seguras para uso en configuraciones de base de datos, archivos de configuración, y más.
El componente está diseñado para ser flexible y fácilmente integrable en diversas aplicaciones Java, proporcionando una solución robusta y segura para la generación de contraseñas que cumplan con criterios de seguridad actuales.

## Características
- Generación de contraseñas seguras y configurables.
- Fácil integración con cualquier componente Swing (`JFrame`, `JDialog`).
- Interfaz de arrastrar y soltar para una fácil manipulación en interfaces gráficas.
## Requisitos
- Java JDK 8 o superior.
- IDE con soporte para Swing si se desea visualizar el componente gráficamente (por ejemplo, NetBeans o IntelliJ IDEA).
## API
### SecurePasswordGenerator

#### Descripción
La clase `SecurePasswordGenerator` es responsable de generar contraseñas seguras basadas en parámetros específicos como longitud, inclusión de símbolos y números. Utiliza un enfoque aleatorio seguro para garantizar que las contraseñas generadas sean difíciles de predecir.

#### Campos
| Tipo | Campo | Descripción |
|------|-------|-------------|
| `String` | `LOWER` | Contiene las letras minúsculas de la A a la Z. |
| `String` | `UPPER` | Contiene las letras mayúsculas de la A a la Z. |
| `String` | `DIGITS` | Contiene los dígitos del 0 al 9. |
| `String` | `PUNCTUATION` | Contiene símbolos comunes utilizados en contraseñas. |

#### Métodos
| Nombre | Tipo de Dato que Retorna | Tipo de dato que recibe | Descripción |
|--------|--------|-------------------------|-------------|
| `SecurePasswordGenerator` | `String` | `int length, boolean includeSymbols, boolean includeNumbers` | Genera una contraseña segura basada en la longitud especificada y la inclusión opcional de símbolos y números. |

---

### GeneratePassword

#### Descripción
`GeneratePassword` es un componente GUI diseñado como un `JPanel` que permite a los usuarios generar contraseñas seguras visualmente. Incluye opciones para copiar la contraseña al portapapeles y transferir la contraseña a un campo de texto externo mediante el uso de métodos específicos.

#### Campos
| Tipo | Campo | Descripción |
|------|-------|-------------|
| `javax.swing.JTextField` | `externalTextField` | Campo de texto externo para recibir la contraseña generada. |

#### Constructores
| Constructor | Descripción |
|-------------|-------------|
| `GeneratePassword()` | Inicializa el componente, establece el tamaño y configura los modelos de los componentes del spinner. |

#### Métodos
| Nombre | Tipo de Dato que Retorna | Tipo de dato que recibe | Descripción |
| ------------------------- | ------------------------ | ------------------------------------------ | ---------------------------------------------------------------------------------------------------------- |
| `setExternalTextField` | `void` | `javax.swing.JTextField externalTextField` | Establece el campo de texto externo donde se mostrará la contraseña generada. |
| `reset` | `void` | | Limpia el texto mostrado en el etiquetado de contraseña, así como las opciones seleccionadas. |
| `btnStartActionPerformed` | `void` | `java.awt.event.ActionEvent evt` | Genera una nueva contraseña basada en las preferencias del usuario y actualiza el campo de texto asociado. |
| `btnCopyActionPerformed` | `void` | `java.awt.event.ActionEvent evt` | Copia la contraseña mostrada en el portapapeles del sistema. |

## Instalación
Para utilizar este componente en tu proyecto, sigue estos pasos:

1. Obtener el repositorio
Clona con el siguiente comando

```bash
git clone https://github.com/JesusAngelMM/ITO_TAP_U2_COMPONENTE_GENERATEPASSWORD.git
```

Otra opción es descargar `ZIP`.
![Descargar ZIP](adjuntos/imagen1.png)

3. Importa el proyecto en tu IDE preferido (NetBeans o VS code).

4. Asegúrate de que el proyecto se compila sin errores para crear el `.jar` según la versión de tu Java.

## Uso
1. Compila tu proyecto para crear el archivo `.jar`

![Compilar proyecto](adjuntos/imagen2.png)
Posteriormente presiona `SHIFT + F11`

2. Agrega el componente a tu paleta de componentes.
Da click derecho en la paleta y selecciona *Palette Manager* y selecciona *Add From Jar*

Navega hasta la carpeta *dist* del proyecto y selecciona el `.jar`.
![Agregar desde JAR 1](adjuntos/imagen3.png)
![Agregar desde JAR 2](adjuntos/imagen4.png)
![Agregar desde JAR 3](adjuntos/imagen5.png)

3. Ya está listo para usar y arrastrar a tus componentes

4. Prueba ya sea en tu `JFrame` o `JDialog` funciona.

![Prueba en JFrame o JDialog](adjuntos/imagen7.png)

Ya puedes generar contraseñas seguras según tus necesidades.

Además puedes copiar y pegar la contraseña generada:

![Usar el copiado y pegado](adjuntos/imagen8.png)

>Recuerda que si quieres usar la contraseña en tu sistema principal, se obtiene a través del método

```Java
generatePassword.setExternalTextField(elemento_recibe);
```
Con esto puedes usar las contraseñas directamente en tu aplicación principal o sistema.

![Usar en el sistema principal](adjuntos/imagen9.png)

Por ejemplo en el programa anterior en el `actionPerformad`del botón se agregó lo siguiente:

```Java
generatePassword1.setExternalTextField(txtDContrasena);
```
Que quiere decir *"lo que generó el componente `generatePassword` copialo en el componente `txtDContrasena`"*.

## Funcionamiento
¡Descubre cómo funciona este componente visual *Generador de Contraseñas*!

Haz clic para ver el video ahora mismo ---> https://youtu.be/Wa5mAOkL6vs.

## Manejo de error común

Abordaremos los problemas de incompatibilidad de versiones que pueden surgir al desarrollar y ejecutar el programa en Java en diferentes entornos, como al intentar ejecutar el programa creado en un entorno de desarrollo, como NetBeans, en otra versión de este mismo entorno o en otra computadora.

![Screenshot1](https://github.com/JesusAngelMM/ITO_TAP_U2_COMPONENTE_GENERATEPASSWORD/assets/167843278/fdfa85bb-5e3c-4fcc-a2da-189dc2e2d657)

Pasos a seguir:

1. En el proyecto selecionamos la opcion *Resolve Project Problems* en donde se describe el problema y seleccionamos *Resolve...*

![Screenshot2](https://github.com/JesusAngelMM/ITO_TAP_U2_COMPONENTE_GENERATEPASSWORD/assets/167843278/baee7e88-26f0-4669-85fe-79a360debc69)

2. Posteriormente seleccionamos (dependiendo el caso nos mostrará alguna de estas opciones):
- *Downgrade Project Source...*: Esta opción te permite ajustar el proyecto para que sea compatible con versiones anteriores del entorno de desarrollo o ejecución de Java.
- *Upgrade Project Source...*: Esta opción te permite actualizar el proyecto para que sea compatible con versiones más recientes del entorno de desarrollo o ejecución de Java.

![Screenshot3](https://github.com/JesusAngelMM/ITO_TAP_U2_COMPONENTE_GENERATEPASSWORD/assets/167843278/d4456a68-a347-4437-ab32-d5dd040205ea)

4. Con esto habremos resuelto los problemas de incompatibilidad con las versiones de Java, por último cerramos la ventana.

![Screenshot4](https://github.com/JesusAngelMM/ITO_TAP_U2_COMPONENTE_GENERATEPASSWORD/assets/167843278/a4c634e6-3d92-4b56-84dd-0207208e857d)

Generalmente, esto no debería ser un problema, ya que NetBeans intentará convertir automáticamente el proyecto al formato compatible con la versión que estás utilizando. Sin embargo, es posible que algunas configuraciones específicas del proyecto necesiten ser ajustadas manualmente después de la conversión.
Posterior a resolver este inconveniente podemos generar nuestro archivo `.jar`

## Contribuir
Si deseas contribuir a este proyecto, por favor sigue los siguientes pasos:

1. Haz un fork del repositorio.
2. Crea una nueva rama para tu característica o corrección de errores.
3. Haz tus cambios.
4. Envía un pull request.

## Autores
- Diego García Jennifer - *Estudiante del ITO* - [Contacto]([JennyDiego (github.com)](https://github.com/JennyDiego))
- Jesús Ángel Martínez Mendoza - *Estudiante del ITO* - [Contacto]([JesusAngelMM (github.com)](https://github.com/JesusAngelMM))

## Agradecimientos
- Gracias a todos los que contribuyeron a este proyecto!
- Al café por quitarme el sueño.