crypt – Băm chuỗi 1 chiều

(PHP 4, PHP 5)
crypt – Băm chuỗi 1 chiều

Miêu tả hàm crypt

Salt là tham số tùy chọn. Tuy nhiên, crypt() sẽ tạo ra mật khẩu yếu nếu không có salt. Từ PHP 5.6 trở đi sẽ xuất hiện lỗi E_NOTICE nếu không có salt. Hãy chắc chắn rằng chỉ định tham số salt đủ mạnh để bảo mật tốt hơn.

Hàm password_hash() sử dụng hàm băm mạnh, tạo ra salt mạnh, áp dụng tự động trong các vòng băm. password_hash() chỉ đơn giản là bao gồm crypt() và tương thích với mật khẩu băm có sẵn. Khuyến khích sử dụng password_hash().

Một vài hệ điều hành hỗ trợ nhiều kiểu băm. Trong thực thế, đôi khi các thuật toán tiêu chuẩn dựa trên DES được thay thế bằng một thuật toán dựa trên MD5. Kiểu băm được kích hoạt bởi tham số salt. Từ phiển bản 5.3 trở về trước, PHP sẽ xác định các thuật toán có sẵn tại thời điểm cài đặt dựa trên hàm crypt() của hệ thống. Nếu không có tham số salt, PHP sẽ tự động tạo ra một chuẩn hai ký tự salt (DES) hoặc mười hai ký tự (MD5), phụ thuộc vào tính sẵn có của MD5 crypt(). PHP thiết lập một hằng số tên là CRYPT_SALT_LENGTH, nó sẽ quyết định độ dài nhất của salt cho các hàm băm sẵn có.

crypt() dựa trên chuẩn DES  trả về salt là 2 ký tự đầu tiên của kết quả. Nó cũng chỉ sử dụng tám ký tự đầu tiên của $str, vì vậy dù chuỗi dài hơn nhưng nếu tám ký tự đầu tiên giống nhau sẽ cho ra cùng một kết quả (khi sử dụng cùng một salt).

Trên hệ thống mà hàm crypt() hỗ trợ nhiều kiểu băm, những hằng số sau đây sẽ được thiết lập là 0 hoặc 1, tùy thuộc vào kiểu băm sẵn có:

• CRYPT_STD_DES – Băm dựa trên chuẩn DES với 2 ký tự salt từ bảng chữ cái “./0-9A-Za-z”. Sử dụng các ký tự không hợp lệ trong salt sẽ dẫn tới hàm crypt() bị lỗi.
• CRYPT_EXT_DES – Băm dựa trên DES mở rộng. salt là một chuỗi 9 ký tự bao gồm một gạch dưới sau đó là 4 bytes đếm lặp và 4 bytes của salt. Đây là những ký tự đã được mã hóa, 6 bits cho mỗi ký tự, ký tự đầu tiên ít quan trọng nhất. Những giá trị từ 0 đến 63 được mã hóa thành “./0-9A-Za-z”. Sử dụng các ký tự không hợp lệ trong salt sẽ dẫn tới hàm crypt() bị lỗi.
• CRYPT_MD5 – băm bằng MD5 với một salt mười hai ký tự bắt đầu bằng $1$
• CRYPT_BLOWFISH – băm bằng Blowfish với salt là: “$2a$”, “$2x$” hoặc “$2y$”, tham số gồm 2 chữ số, “$”, và 22 ký tự từ bảng chữ cái “./0-9A-Za-z”. Sử dụng những ký tự ngoài dải này cho salt sẽ dẫn tới việc crypt() trả về một chuỗi độ dài là 0. Hai chữ số trong phần tham số log cơ số 2 của của vòng lặp cho nền tảng thuật toán băm dựa trên Blowfish và phải ở trong dài từ 04-31, những giá trị ngoài dải này sẽ dẫn tới hàm crypt() bị lỗi. Trước phiên bản 5.3.7, PHP chỉ hỗ trợ “$2a$” như là một tiền tố của salt: PHP 5.3.7 giới thiệu các tiền tố mới để khắc phục một điểm yếu bảo mật trong việc thực thi Blowfish. Vui lòng tham khảo tài liệu này để biết thêm chi tiết về những lỗi bảo mật đã được khắc phục, nhưng tóm lại, các nhà phát triển chỉ tập trung vào PHP phiên bản 5.3.7 trở về sau nên ưu tiên sử dụng “$2y$” hơn “$2a$”.
• CRYPT_SHA256 – băm bằng SHA-256 với mười sáu ký tự salt có tiền tố là $5$. Nếu chuỗi salt bắt đầu với ’rounds=<N>$’, giá trị của số N sẽ được sử dụng để quyết định vòng lặp băm sẽ chạy bao nhiêu lần, nhiều như tham số của Blowfish. Mặc định số vòng lặp là 5000, nhỏ nhất là 1000 và lớn nhất là 999,999,999. Bất kỳ giá trị nào của N ngoài dải này sẽ được thay đổi tới giá trị giới hạn gần nhất.
• CRYPT_SHA512 – băm bằng SHA-512 với mười sáu ký tự salt có tiền tố là $6$.Nếu chuỗi salt bắt đầu với ’rounds=<N>$’, giá trị của số N sẽ được sử dụng để quyết định vòng lặp băm sẽ chạy bao nhiêu lần, nhiều như tham số của Blowfish. Mặc định số vòng lặp là 5000, nhỏ nhất là 1000 và lớn nhất là 999,999,999. Bất kỳ giá trị nào của N ngoài dải này sẽ được thay đổi tới giá trị giới hạn gần nhất.

Tham số

string

Chuỗi ký tự cần băm.

salt

Tham số sẽ quyết định thuật toán nào được thực thi. Nếu không có, thuật toán sẽ tự động cung cấp tham số và có thể dẫn đến kết quả sẽ không như mong đợi.

Giá trị trả về

Trả về chuỗi băm hoặc một chuỗi ngắn hơn 13 ký tự và được đảm bảo khác với tham số salt nếu quá trình băm bị thất bại.

Ví dụ

Ví dụ 1 về hàm crypt()